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Preface 


To my fellow students of mathematics 


This book is written for you. This is the book that I wish someone had written for 
me. This is a book that introduces the C++ language for people who are interested 
in solving mathematical problems. 

There is a dizzying selection of books on C++ written for a wide array of au- 
diences. Visit your favorite bookseller and you can find C++ books for finance, nu- 
merics, computer security, game programming, embedded controllers, graphical user 
interfaces, network protocols, data and file structures, engineering, scientific comput- 
ing, digital signal processing, simulation, neural nets, artists, virtual machine design, 
graphics, computational physics, cellular automata, cryptography, Web agents, busi- 
ness, aerospace and flight simulation, music and MIDI instruments, mobile phones, 
language translation, computer-aided design, speech recognition, database develop- 
ment, computer architecture, photographic imaging, fuzzy logic, hardware control, 
rigid body kinematics, real programmers, and—of course—for dummies. 

We assume that none of the above applies to you. We approach C++ from the 
point of view of solving mathematical problems. We organize our discussion around 
the mathematics and bring in the relevant C++ ideas as we need them. 


Why C++? 


There is a plethora of computer tools available to the mathematical scientist. Many 
of these are suited for specific purposes. For example, if you need to perform exten- 
sive calculations in support of a number theory problem, the Pari package is perfect. 
There is a variety of commercial software packages that are excellent for mathemat- 
ical work including Maple, MATLAB, and Mathematica to name but a few. 

For many mathematical problems, these systems work perfectly. However, for 
problems that require extensive computation the speed of a compiled language such 
as C++ cannot be beat. A C++ program can work through billions of examples faster 
than most other computing choices. 

The length of time it takes to solve a problem on a computer begins not when you 
run your program; it begins when you first start to write your program. The object- 
oriented nature of C++ enables you to create correct programs quickly. Furthermore, 
there is an extensive collection of C++ programs freely available on the Web that can 
be customized and used for your purposes (we discuss a few of these in Chapter 13). 

In addition, C++ is available for free on most computer systems. See Appendix A 
for more information about different versions of C++ for various computing envi- 
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ronments (Windows, UNIX, Macintosh). 


What can my computer do for me? 


Although the utility of computers in the sciences and engineering is unquestion- 
able, it is not as clear that a computer is useful for mathematics. However, there are 
several arenas in which a computer can be a mathematician’s best friend. 


e Symbolic computation. Mathematical work often requires us to fuss with 
formidable formulas and solve elaborate equations. Computer algebra systems 
such as Maple and Mathematica are extremely useful for such work. 


e Visualization. The computer can draw precise pictures and diagrams; often 
these images provide key insights to understanding problems. 


e Examples and counterexamples. The computer can run through millions of 
examples and try myriad possibilities. It is a laboratory in which to perform 
experiments to see if ideas work and for discovering patterns. 


e Contribution to proof. Sometimes, parts of proofs can be relegated to the 
computer for checking. A celebrated example of this is the 1970s-era proof 
of the Four Color Theorem by Appel and Haken. More recently, Tom Hales’s 
announced proof of the Kepler Conjecture required extensive computation. 


I have used the computer in all these ways in my research. Allow me to share an 
amusing anecdote in which the computer contributed to the proof of a theorem. I was 
working with two colleagues on a problem in discrete mathematics. We knew that we 
could complete one portion of the proof if we could find a graph with certain specific 
properties. We carefully wrote down these criteria on a blackboard and set out to 
find the elusive graph. Although we tried to create the required graph by hand, each 
example we tried took us several minutes to check. We realized that the criteria could 
be checked mechanically and so we wrote a program to generate graphs at random 
until one with the needed properties was found. The first time we ran the program, 
it asked us for the number of vertices. Because we were unsuccessful with small 
examples, we typed in 50. Nearly instantly we were rewarded when the computer 
printed out a few screenfuls of data specifying the graph. 

Heartened by this (but not wanting to tangle with such a large graph), we ran the 
program again asking for a graph with only 20 vertices. Again, we were greeted 
with near instant success. We started to draw the graph on the blackboard, but it was 
a nasty random mess (no surprise—our program was designed to examine random 
graphs one after another). One more run. Shall we be optimistic? Certain this would 
not work, we ran the program again for graphs on 5 vertices. Success! The graph 
was actually quite simple and we had a good laugh over how we found our answer. 
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Using this book 


This book is ideal either for self-study or as a text for a semester-long course 
in computer programming (with an emphasis on mathematics). It is important that 
undergraduate mathematics majors know how to use the computer effectively. This 
is a skill that will serve them well whether for applied scientific/engineering/financial 
work, or as a means for forming and testing conjectures in pure research. 

We explain how to use C++ from the ground up, however, some experience in 
writing programs in any language will help. The reader does not need extensive 
experience in programming. Nor is a deep mathematical background needed to 
read this book. Our examples are drawn from standard mathematical topics such 
as Pythagorean triples [integers (a,b,c) such that a* + b” = c?] and polynomials. 

Whether you are reading this book on your own or in conjunction with a course, 
the most effective way to learn is to do. Every chapter ends with a collection 
of exercises; do them all. This is important for two reasons. First and foremost, 
mastery of any skill requires practice, and learning C++ is no exception. Second, 
additional ideas and subtle points are explored in the exercises. To assist you, we 
include complete solutions to nearly every exercise in Appendix D. 


Organization 


We organize our discussion around mathematical themes. For example, Chapters 3 
to 5 cover many central ideas in C++ (from how to write procedures to dynamic 
allocation of arrays), but a single mathematical problem runs throughout, taking us 
from Euclid to Riemann. 

The main body of the book is divided into three parts: Procedures, Objects, and 
Topics. 

Procedures focuses on writing C++ procedures (often called functions by our com- 
puter science colleagues, but we have a different meaning for that word). Objects in- 
troduces the object-oriented method of programming. If you want to solve a problem 
that involves permutations, Chapter 11 shows how C++ can handle these structures 
nearly as comfortably as it handles integers. Yopics discusses how to use freely 
available packages that you can use in your programs, more advanced input/output, 
visualization, and selected special features of the C++ language. 

Four appendices provide (A) an overview of computing systems (including In- 
tegrated Development Environments), (B) the use of the Doxygen documentation 
system, (C) a quick reference to the C++ language and supporting libraries, and 
(D) answers to nearly every exercise. 


No pointers! (almost) 


The C++ concepts covered in this book are not exhaustive. There are aspects 
of the language that are relevant only to computer scientists and software engi- 
neers. For example, C++ provides a number of exotic casting operators (such as 
reinterpret_cast) that are not of interest to mathematicians; we omit those. Nei- 
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ther multiple inheritance nor pure virtual functions are for us. We do not explain how 
to make C++ programs work with other languages such as assembly language. We 
don’t create our own namespaces. For these and other C++ topics that are useful to 
large software engineering projects, please refer to any of several excellent, compre- 
hensive C++ reference books. 

One topic that we touch only gently is the use of pointers. Mostly, we do not need 
them. We successfully avoid this confusing (and errorprone) concept through the 
use of call-by-reference and STL container classes. A mathematician shouldn’t be 
worrying about exotic data structures such as red—black trees; we just want to insert 
and delete elements in a set and not to worry about how the computer manages the 
set. 

There are, however, a few instances where a rudimentary understanding of pointers 
is necessary. 


e The name of a C++ array is a pointer to its first element. We need to understand 
this when we pass an array to a procedure and when we dynamically allocate 
storage for an array. 


e Sometimes an object needs to refer to itself (e.g., when a method such as 
operator+= returns the value of the object). In these instances, the this 
pointer is useful. 


We do not provide an extensive discussion of string processing (but do cover the 
basics in Chapter 14). As mathematicians, we are interested in getting data into our 
programs and results out of them; we are not going to construct word processors. 

We omit the exotic and focus on those aspects that make C++ a formidable weapon 
in the mathematician’s arsenal. With your brain and this book, your problem doesn’t 
stand a chance. Enjoy! 


Additional resources 


The CD-ROM that comes with this book includes the code for all the numbered 
programs (see the List of Programs on page xiii). The programs are free for you to 
use under the terms of the GNU General Purpose License. (See the CD-ROM for 
details.) The disk also includes solutions to some of the lengthier exercises. 

Please visit the Web site for this book www.ams.jhu.edu/~ers/cpp4m/ where 
we maintain a list of errata and submissions for Exercise 1.1.5. 
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Part I 


Procedures 


Chapter I 





The Basics 





1.1 What is C++? 


C++ is a computer programming language. 


Computers are electronic information-processing machines. Data and programs in 
these machines are saved, moved, and transformed in the form of electrical voltages. 
These electrical voltages can be interpreted as a zeros and ones. The zeros and 
ones can be aggregated and interpreted as words, numbers, images, sounds, and 
so on. Long ago, information—be it data or programs—could be entered into the 








Figure 1.1: A PDP-8 computer with front panel switches for entering instructions 
and data. (Image courtesy of the Computer Museum at the University of Stuttgart. 
Photograph by Klemens Krause.) 
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computer by manipulating switches on the front of the machine. Today, there are 
better methods. Computer programming languages convert text into the requisite 
binary instructions. 

C++ is a compiled language. This means that before the program is run, it is first 
translated into a form that the machine can use directly. The C++ files (and a typical 
project contains several) are called the source files. You create the source files by 
typing them using a program called a text editor. 

The translation of the source files into a program proceeds in two phases. First, 
the individual source files are translated by a program called the compiler into so- 
called object files. Next, a second program, called a linker (or loader) combines 
the individual object files into an executable file, that is, a program you can execute 
(run). 

The precise manner in which is all this is done (source file creation/editing, com- 
piling, linking, and execution) varies among different computing platforms. In Ap- 
pendix A we discuss how this is done for some common computing platforms (Win- 
dows, Macintosh, UNIX). 

Ideally, you have already done some programming, say in C, and so you are famil- 
iar with the general flow of this process. If not, your best option is to have someone 
show you how to perform these basic steps. In theory, your computer contains doc- 
umentation that explains all this. However, such documentation is most useful to 
someone who already knows what to do, but needs reminders on specifics. 

With the help of Appendix A, a friendly neighbor knowledgeable in programming, 
and documentation (if any) you will get past this first, often frustrating hurdle. Rest 
assured that the process is simple once you know what it is. The hard part is knowing 
just which menu to select or what command to type to set the process in motion. For 
example, on many computers you translate your C++ files into a working program 
with the single command: 


gtt *.cc 


and then run your program by typing this: 


./a.out 


If you are using an integrated development environment (also called an IDE) com- 
piling your C++ files may be as simple as clicking on a button that says “build” and 
then running your program by clicking on a button that says “run”. 





1.2 Hello C++ 


To begin we need to write a program; it’s time to present our first example. It 
is traditional to start with a program that does nothing more than type the words 
Hello, world onto the computer screen. Instead, we opt for a bit of (bad) poetry. 
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Program 1.1: The classic “Hello, world” program updated for the mathematics 
world. 


#include <iostream> 
using namespace std; 


[xx 
x A simple program for demonstrating the basics of a C++ project. 
* 
* It does a good job of demonstrating C++ fundamentals, but a 
x terrible job with the poetry. 
*/ 
Hiinte. iqehinian()) i 
cout << "Don’t you just feel like a louse"; 


cout << endl; 


cout << "To learn that your \"new\" theorem was proved by Gauss?"; 
cout << endl; 


return 0; 





There are naming conventions for C++ program files. The name of the file that 
contains this code is poem.cc. The name has two parts: poem is called the base 
name and .cc is called the extension. The base name can be more or less anything 
you like, but the extension should be .cc. Other extensions that are permissible for 
C++ programs are .C, .cpp, and .cxx. The extension is important because this is 
what the compiler uses to recognize that your file contains C++ code. 

Let’s analyze poem. cc to understand the purpose of its various parts. 

The core of this program is in lines 12—16, so we begin our discussion there. Line 
12 contains four important components. 


e The cout object: This is an object to which we send information that we want 
written on the computer screen. The word cout is an abbreviation of “console 
output.” 


e The << operation: This is an operation that acts on the objects immediately 
to its left and right: in this case, the cout object on its left and the character 
array (described next) on its right. 


e The character array enclosed in quotation marks: These are the words Don’ t 
you just feel like a louse. The quotation marks mark the beginning 
and end of the character array. Note that the single quote (apostrophe) is a 
valid character. 


e The statement terminator: The semicolon at the end of the line denotes the end 
of the statement. 
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As mentioned, the << operation takes two arguments: the cout object on its left and 
the character array on its right. The effect of this operation is that the character array 
is typed onto the computer’s screen. 

The semicolon at the end of the line is mandatory; it marks the end of the state- 
ment. We could have broken this statement into two (or more lines), like this, 


cout 
<< 


"Don’t you just feel like a louse" 

Line 13 is similar to line 12, but in place of the character array, we have the endl 
object. The endi stands for end of line; it causes the computer’s output to move 
to a new line in the output. Without this statement, the next output would begin 
immediately after the e in the word louse. 

Lines 15 and 16 write the second line of the poem to the computer screen. The 
only interesting thing here is that we want quotation marks to be part of the output 
(surrounding the word new). Because quotation marks signal the beginning and end 
of the character array, we need a way to indicate that the quotes around new are not 
delimiters, but part of the text message. This is done by preceding the " mark with a 
backslash, \. 

Lines 12 through 16 comprise four separate statements. These could be combined 
into a single statement without loss of clarity. The various objects to be printed can 
be fed to cout by repeated use of the << operation. 

cout << "Don’t you just feel like a louse" << endl 


<< "To learn that your \"new\" theorem was proved by Gauss?" 
<< endl; 


Here is the output of the program. 





cr 


4 
Don’t you just feel like a louse 
To learn that your "new" theorem was proved by Gauss? 





The other parts of the program are important, too. Let’s examine them one by one. 


e The first line of the program is #include <iostream>. This line is neces- 
sary to incorporate the definitions of various input/output objects and opera- 
tions. The objects cout and end1 are not in the main part of C++, and need 
to be read into the program. 


Ironically, this first line of our first C++ program is not actually C++ code. It 
is a request to the C++ compiler to read a file called tost ream and include 
the contents of that file in this program. The file iost ream is called a header 
file. This header file is part of the C++ system, and so is called a system header 
file. Soon, you will write your own header files, and those are known as user 
header files. 


The compiler knows where to find iost ream and before it does anything else 
with your program, it inserts the full contents of the file iost ream at the start 
of your program. 
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Because this line is not a C++ statement, no semicolon is needed at its end. In- 
structions that begin with the # sign are preprocessing directives. We examine 
a few other such commands later. 


Any time you write a C++ program that reads or writes data from the computer 
screen, you need to include the iost ream header. 


Line 2 is particularly inscrutable. For now, just know that if you use #include 
to read in any standard system header files, then you must have the statement 
using namespace std; as well. 


You may safely skip the rest of this explanation. The objects cout and end1 are 
not core parts of C++, but standard additions to the language. It is possible that 
a software developer—let’s call her Sophie—might want a different version of 
cout that is somehow different from the standard version. 


Sophie also wants to call her console output object cout; this is possible in 
C++. Sophie creates (don’t worry about how, you are not a software developer) 
a separate namespace, which she calls, say, sophie. The full name of Sophie’s 
cout is sophie::cout. The full name of the standard cout is std::cout, 
where std stands for the “standard” namespace. 


In the iostream file, cout and endl are defined to have the full names 
std::cout and std::endl. It is possible to delete line 2 from the program, 
but then it would be necessary to replace cout with std: : cout (and likewise 
for endl). However, for our purposes, it is much easier to declare: we are 
going to be using the standard namespace, so we will use the short forms of 
the names. That’s what the statement using namespace std; does. 


Lines 4—9 are a comment. Comments are important features of computer pro- 
grams. This comment immediately precedes the main part of the program and 
explains what the program does. 


Comments in C++ are of two forms: multiple-line comments and single-line 
comments. 


Multiple-line comments may span one or more lines. The comment begins 
with the pair of characters /* and ends with «/. Everything between these is 
ignored by the compiler; the comments are meant for a human reader. The 
comment spanning lines 4 through 9 is of this sort. The single asterisks on 
lines 5 through 8 are present only to make it clear that this block of text is a 
comment. Clean formatting like this makes the program more readable. The 
extra « on line 4 serves a purpose that is revealed later (see Appendix B); for 
the present, you can think of it as optional. 


Single-line comments begin with a double slash // and continue to the end of 
the line. They are useful for short comments. For example, to explain line 12 
of the program, I could have written this: 


cout << "Don’t you feel like a louse"; // rhymes with Gauss 
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e Line 11 and lines 18-19 surround the main part of the program. As we create 
more elaborate C++ programs, we separate the program into multiple files, 
with each file containing various procedures. In each program, there must be 
exactly one procedure whose name is main. We examine procedures in more 
detail later, but for now here is what you need to know. 


— Procedures take various values as arguments, execute instructions, and 


return a value. In this case, the procedure named main returns an integer 
value; this is signified by the word int before the name of the procedure. 
The value returned is zero, and this is accomplished at the end of the 
procedure with the statement return 0; which returns the value 0. 


The main procedure does not take any arguments; this is signified by 
the empty pair of parentheses following the word main. There is an 
alternative way to create a main procedure that does take arguments; we 
explore that later (see Chapter 14). 


Thus the beginning of line 11, int main(), says that this is a procedure 
that takes no arguments and returns an integer-valued answer. 

After int main (), the statements of the procedure are enclosed in curly 
braces. The opening curly brace is on line 11 and its matching closing 
brace appears alone on line 19. 

Notice that lines 12-18 are indented from the left margin. This indenting 
helps enormously with readability. 


This completes our analysis of Program 1.1. 





1.3 Exercises 


1.1 The following comment in a C++ program would cause the compiler to issue 
an error message. 


/x* 


* In C++ comments ar nclosed between /* and «*/ 


*/ 





What’s wrong? 


1.2 The following program is typed into the computer and saved as bad.cc. 


#include <iostream> 


int main() { 
cout << "What is wrong with this program?" 
cout << endl; 


1.3 


1.4 


1.5 


The Basics 9 


return 0; 


When this program is compiled, the following output is produced. 


bad.cc: In function ‘int main()’: 

bad.cc:4: error: ‘cout’ undeclared (first use this function) 

bad.cc:4: error: (Each undeclared identifier is reported only 
once for each function it appears in.) 

bad.cc:5: error: parse error before ‘<<’ token 


There are two errors in the program. Use the output to figure out what those 
errors are. 
A programmer included the following line in a program. 


cout << "My favorite web site is http://www.google.com"; 


Do the slashes // start a comment? 


To include a quotation symbol in output, we use the sequence \". Write a 
program to see what the sequences \n, \t, and \\ do when part of a character 
sequence. 


For example, your program should contain a line such as this: 


cout << "What does \n do?"; 


Write your own bad math poem. There’s great potential for a terrible rhyme 
with Euler including under the broiler and stop or you’re goin’ to spoil her 
and how long does an egg boil fer? 


Send your worst to the author at ers@jhu.edu and we’ll post the best/worst 
on this book’s Web site www.ams. jhu.edu/~ers/cpp4m. Use math poem 
as the subject line of your message. 
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Chapter 2 





Numbers 


Numbers are the building blocks of mathematics and, of course, computers are ex- 
tremely adept with numbers. There are several ways in which numbers are handled 
in C++. In this chapter, we explore the different representations of numbers and how 
to convert between representations. We also catalogue the various operations we can 
perform with numbers. 

Numbers in C++ are divided into two broad categories: integers and reals. Each 
of these categories is refined further. Of course, to a mathematician every integer 
is a real number, so these categories may seem spurious. The reasons for having 
many different ways to represent numbers are efficiency and accuracy; if the quan- 
tities with which we are computing are known to be integral, then using an integer 
representation is not subject to roundoff error and the computations are faster. 





2.1 The integer types 


Every variable in a C++ program must be given a type. The type of a variable is a 
specification of the kind of data the variable can store. The most basic type is int. 
An int represents an integer quantity. Consider the following program. 





Program 2.1: Introducing the int type. 
#include <iostream> 


using namespace std; 


aLinte. inaystsliah(()) 4 
IME $29 
eG seat a 


COUL. << -xety. << endl: 


return 0; 


} 
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In this program, two variables, x and y, are declared to be of type int. These 
declarations occur on lines 5 and 6. C++ requires that we specify the type of every 
variable, and the declaration statement is the manner by which this is accomplished. 
Variables may be declared anywhere in the program so long as they are declared 
before they are used. 

Subsequently (lines 8 and 9) the variables are assigned values. In this case x is 
assigned the value 3 and y the value 4. The equal sign = is an operation (called 
assignment) that stores the value of the expression to its right into the variable on its 
left. 

It is possible to combine declarations on a single line; in place of lines 5 and 6, we 
could have this: 


int x,y; 


It is possible to combine declaration with assignment. Lines 5—9 can be replaced 
by these two: 
int x = 3; 
int y = 4; 

It’s easy to see what the rest of Program 2.1 does. In line 11, the contents of x and 
y are added, and the result is written on the computer’s screen. 

Variables of type int can store a finite range of integer values. The size of that 
range depends on your specific computer. On many computers an int is held in 4 
bytes of memory (one byte is 8 bits, so this is 32 bits). With 32 bits one can store 2°” 
different values. In this case, the 232 values are from —22! to 23! — 1 inclusive. 

There is an easy way to learn the size of an int on your computer in C++ with the 
sizeof operator. Evaluating sizeof (int) gives the number of bytes used to store 
variables of type int. If an int on your computer is b bytes long, then the minimum 
and maximum values an int may hold are —2?-! and 2°~! — 1, respectively. See 
also Program 2.3 later in this chapter (page 15). 


There are a few variations of the fundamental int type. 


e A short is an integer type that is either the same as int, or else a smaller size 
than int. That is, sizeof (short) cannot exceed sizeof (int). 


e A long is an integer type that is either the same size as int, or else a larger 
size than int. In other words, sizeof (long) is at least sizeof (int). 


e Some compilers provide a long long type. This is an integer type that is at 
least the size of a long. That is, sizeof (long long) cannot be less than 
sizeof (long). 


Other compilers may provide an equivalent alternative. For example, in Mi- 
crosoft’s Visual Studio, use the type __int 64 (the name begins with two un- 
derscore characters) in place of long long. 


In summary, 


sizeof (short) < sizeof (int) <sizeof (long) <sizeof(long long). 
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Finally, each of the integer types can be modified for holding only nonnegative 
integers using the unsigned keyword. For example, a variable can be declared 


unsigned int x; 


In this case, x may take on only nonnegative values. If sizeof (unsigned int) is 
4, then x can be any value from 0 to 27? — | inclusive. 


Because integer variables are of finite capacity, if a calculation exceeds the limits 
incorrect results emerge. Consider the following program that we run on a computer 
on which sizeof (int) equals 4. Please note the operation * in the code which is 
used for multiplication. 





Program 2.2: A program to illustrate integer overflow. 


#include <iostream> 
using namespace std; 


[xx 
* A program to illustrate what happens when large integers 
* are multiplied together. 


x/ 
Elbratemmenrl cleierin (9) meet 
int million = 1000000; 
aoe iGo = iii iilseie <s indalil Iaiojo? 
Cote K< WNeieoxebiiots in ielduks @enijouleer, 9 <<< iuilliliem << " geiuleueerel ae; 1 


eS erilisioa << Mo << einelila 





Line 10 defines a variable mi11ion equal to 10°. Because 2?! is roughly 2 billion, 
there is no problem assigning x this value. However, when we define (line 11) y to 
be xxx, the result of squaring x is greater than 23!. What happens? Let’s run the 
program and see. 





According to this computer, 1000000 squared is -727379968. ‘ 





The result is obviously wrong! Unfortunately, such errors are rarely so easy to 
detect. Here is some advice on how to handle this situation. First, know the sizeof 
of the various integer types on your machine (see Program 2.3 later in this chapter). 
Second, use long or long long routinely unless for reasons of speed or space you 
need to use a smaller size. Finally, if the Long or long long type is not big enough 
for your calculations (and you need to keep the full precision) you can learn about 
arbitrary precision arithmetic packages (see Section 13.1). 
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2.2 The real number types 


C++ can handle more than integers. Real numbers are represented using floating 
point approximations. There are two principal types of floating point types: float 
and double. Both hold real values of limited precision. Variables of type float use 
less memory and have less precision than those of type double. 

Some computers may have a long double type that has even greater precision 
than double. 

Unless you have special needs (for increased speed or decreased memory), use the 
double type for all your real number calculations. 

One may be tempted to use double for all numbers. For example, if we replace 
int by double in Program 2.2, we have the following output. 





According to this computer, let+t06 squared is let12. } 





Notice that the value of x is reported as 1e+06; this is simply scientific notation for 
1 x 10°. The value of y is 1e+12 and this is correct: 10!”. 

So why bother with the integer types at all? First, if the problem you are solving 
deals with integers, using int or long is more efficient than float or double. 
Second, the integer types are not subject to roundoff errors. Finally, there are certain 
instances in which an integer type is required by C++ (e.g., when accessing elements 
of an array). 





2.3. The bool and char types 


There are other basic data types available in C++. Two that we encounter fre- 
quently in C++ are designed for handling Boolean and character data. 

The data type bool is used to represent the logical values TRUE and FALSE. In 
C++, these are represented as integers: 1 for TRUE and 0 for FALSE. Indeed, boo] is 
considered to be an integer type. 

Boolean values emerge as the result of comparison operations. In C++, to see 
if two variables hold equal values we use the == operator. The result of x == y is 
either | (TRUE) in the case where x and y hold equal values and 0 (FALSE) otherwise. 
If your program contains the statement 


cout << (x==y) << endl; 


either a 0 or a 1 is typed on the screen. 


Individual characters have the type char. One can create variables to hold single 
characters by declaring them to be of type char as in this example. 


COA NDNFP WN TOAANADUNA FP wWN 
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char x; 
x =A’; 
cout << x << endl; 


This code causes the letter A to appear on the computer’s screen. 

Notice that a single character is enclosed in single quotes. Arrays of characters 
are enclosed in double quotes. It is incorrect to write char x = "A"; because x is 
of type char whereas "A" is an array of elements of type char. 

C++ has two principal ways of handling textual data: arrays of characters and 
objects of type string. We discuss these later (see Chapter 14). However, pro- 
grams whose purpose is to solve mathematical problems rarely have much need for 
extensive processing of textual data. 





2.4 Checking the size and capacity of the different types 


Earlier we mentioned the sizeof operator that is used to determine the number 
of bytes a given data type occupies in memory. The following program reports on 
the sizes of the various basic data types we have discussed. 





Program 2.3: A program to show the sizes of the fundamental data types. 


#include <iostream> 
using namespace std; 


[xx 

x Report on the size of various C++ data types. 

* 

* This program may give different results when run on different 

* computers depending on how each of the fundamental data types is 
* defined on those platforms. 

*/ 


int main () 
// Integer types: 


Soul <= “INS sage 5G sort a5. 9) 24. Sa 2650 (enor) 
ax UW jones << Chevelle 

eee «<< Vallee Saime Oi Slits aus Y << ssalwerese (slinic)) 
<< Joes! << Gyayelilp 

Coues << WiWeS Sawe Ole Mee ats | K< Siweoie (ihkeie;) 


<< " bytes" << endl; 


// long long might not exist on all computers 
SCout <<; “Iihe<sige* or Tong long as." «<< siceom long tong) 
<< " bytes" << endl; 








// Character and boolean types: 
Gone << Wwe Saiwey Ole Clee ale " K< Saimweo@ie (eligia) «<< WW joceel << GCiaelilp 
Cone << VINnS Siiwe. Orr loyo@ll ae W Kz Baiweoir (oaoo@ilh) «<< lovee! << Giselle 











28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
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// Floating point types 


Come << Wile sive Or Jeleee aig VY hx ealzasrone (ar l@eic)) 
<< " bytes" << endl; 
cout << "The size of double is " << sizeof (double) 


<< " bytes" << endl; 
// long double might not exist on all computers 
cout << "The size of long double is " << sizeof(long double) 


Kee U jonimecer? <<< Guavelile 


return 0; 





The output of this program depends on the computer on which it is run. The 
following show the results of running this code on two different machines. 





The size of short is 2 bytes 

The size of int is 4 bytes 

The size of long is 4 bytes 

The size of long long is 8 bytes 
The size of char is 1 bytes 

The size of bool is 4 bytes 

The size of float is 4 bytes 

The size of double is 8 bytes 

The size of long double is 8 bytes 














The size of short is 2 bytes 

The size of int is 4 bytes 

The size of long is 4 bytes 

The size of long long is 8 bytes 
The size of char is 1 bytes 

The size of bool is 1 bytes 

The size of float is 4 bytes 

The size of double is 8 bytes 

The size of long double is 12 bytes 








A 





Notice that an int is 4 bytes on both machines and so, in both cases, int variables 
can hold values from —2! to 23! —1, 

Note also that double variables on both machines are 8 bytes, but this does not 
tell us the range of values that double values can take. 

For the float and double data types, there are three quantities of interest: the 
largest value, the smallest positive value, and the difference between | and the small- 
est value greater than 1. This latter value is known as the epsilon value of the data 
type. Knowing that a double is 8 bytes does not immediately reveal these three 
quantities. 

C++ provides header files with this information. The header file climits gives 
the minimum and maximum value of various integer types. It defines symbols such 
as INT_MIN and INT_MAx that are equal to the smallest and largest value an int 
may hold. Similarly, the header file cfloat gives the minimum positive, maximum, 
and epsilon values for float, double, and long double (if available) data types. 


COCAHANDUNAPWNKFK THUAN ADAUNFwWN 
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Running the following program reports all this information for the data types we 
have discussed. 





Program 2.4: A program to show the maximum and minimum values of various data 


types. 

#include <io 
#include <cl 
#include <cf 
using namesp 


[xx 
Ree pana Suomen e | Out 


*/ 


int main () 
@roine. <<. Wan 
Grohe: <<<. WAL 


Gouie <<< Min 
Crore <<< 0 


Cowie «<i Yan 
eoune << Wav 


(gy Ce toa pas 
COU <a 
Crosie, <<< a0 


cour << Vi 
<<a 
Gomis <<< Vi 
C< IPI 
Grose, <<< 
<< IPI 


COs << Ya 
<<a) 
Cowie «<< aN 
<< IDES 
Grohe, << Mar 
<<a) I) 





// long do 
exoimc. <<< Ww 
<<) 
Gouin << Mal 
<< ID) 
Crorsie <<< 0 
<<a) 





return 0; 


stream> 

imits> // max & min size of integer types 
loat> // max & min size of real types 
ace std; 


the extreme values of various integer types. 


he maximum size o 
he minimum size o 


a short is " << SHRT_MAX << endl; 
él isinfoweie abe) WY <<< Sisistr ion) <<< Gyaveblls 


Fh Fh 


he maximum size of an int is " << INT_MAX << endl; 
NS TLiaibN GLAS Cue ~isi iste ae Y << IN E_WanN) << einclils 


he maximum size o 
he minimum size o 


a long is " << LONG_MAX << endl; 
a long is " << LONG_MIN << endl; 


Fh Fh 


ng values might n 
he maximum size o 
he minimum size o 


t exist on some computers 





Fy Fh O 


he minimum positive value of a float is " 


LT MIN << endl; 


he minimum epsilon value of a float is " 
T_EPSILON << endl; 

he maximum value of a float is " 

T_MAX << endl; 

he minimum positive value of a double is " 
L_ MIN<< endl; 

he minimum epsilon value of a double is 
L_ EPSILON << endl; 

he maximum value of a double is " 

[ MAX << endl; 


uble might not be defined on some systems 

he minimum positive value of a long double is " 
BL_MIN<< endl; 

he minimum epsilon value of a long double is " 
BL_EPSILON << endl; 

he maximum value of a long double is " 

BL_MAX << endl; 








a long long is " << LLONG_MAX << endl; 
a long long is " << LLONG_MIN << endl; 
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Here is the output of this program on a particular computer. The result on other 
computers may be different. 








The maximum size of a short is 32767 

The minimum size of a short is —32768 

he maximum size of an int is 2147483647 

he minimum size of an int is —2147483648 

he maximum size of long is 2147483647 

The minimum size of long is —2147483648 

he maximum size of long long is 9223372036854775807 

he minimum size of long long is —9223372036854775808 
he minimum positive value of a float is 1.17549e-38 

he minimum epsilon value of a float is 1.19209e-07 

he maximum value of a float is 3.40282e+38 

he minimum positive value of a double is 2.22507e-308 

he minimum epsilon value of a double is 2.22045e-16 

he maximum value of a double is 1.79769e+308 

The minimum positive value of a long double is 2.22507e-308 
The minimum epsilon value of a long double is 2.22045e-16 
he maximum value of a long double is 1.79769e+308 




















2.5 Standard operations 


C++ provides the familiar arithmetic operations. The expressions x+y, x-y, x*y, 
and x/y are the usual sum, difference, product, and quotient of x and y. 

In these expressions, x and y may be any of the numeric types we discussed. 
However, mixing types can sometimes cause problems and confusion. If x and y 
are of the same type, then the result of the operation is also that type. For example, 
consider the following code. 
int numerator = 13; 


int denominator = 5; 
double quotient; 


quotient = numerator/denominator; 
cout << quotient << endl; 


We might expect this code to print the value 2.6 on the computer’s screen. The 
surprise is that the computer prints 2. To understand why, we have to remember that 
when two int values are divided, the result is an int. In this case, C++ divides the 
integers 13 and 5 to give the result 2 (the fractional part is lost) and then assigns 
that value to quotient. Because quotient is of type double there is a silent, 
behind-the-scenes conversion of the int quantity into a double quantity. 

We can coerce C++ to give us the answer 2.6 by converting 13 or 5 (or both) 
into double variables. We replace quotient = numerator/denominator with 
this: 
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quotient = double(numerator) / double (denominator) ; 


The expression double (numerator) converts the integer value in numerator into 
a double quantity. This conversion process is known as casting. Note that the 
variables numerator and denominator are unaffected by this; they remain type 
int and their type cannot be changed. What double (numerator) does is create a 
temporary double number to be used in the division. 

We do not have to cast both numerator and denominator to type double. Once 
we cast one of them to double, we have an expression involving a double and an 
int. In this case, C++ automatically converts the other value as well. 

Algebraic expressions may contain explicit numbers in addition to variables, such 
as x = 2*x+3;. This expression means that we take the value of x, multiply that by 
2, then add 3, and then save the result of the calculation back into x. So if the initial 
value of x is 10, after this statement x would hold the value 23. 

Numbers written without a decimal point are assumed to be integers, and numbers 
with decimal points are assumed to be floating point values. Consider the following 
code. 
cout << 13/5 << endl; 
cout << 13./5 << endl; 


cout << 13./5. << endl; 
cout << 13/5. << endl; 


The first of these prints 2 and the other three print 2. 6. 


For integer variables, the percent sign denotes the mod operation. The expression 
237 % 100 evaluates to 37. 

Unfortunately, the % operation is not exactly the same as the mathematician’s mod. 
For us, when a and b are integers with b > 0, we have that a mod b is the remainder 
r in the division of a by b where r must satisfy 0 < r < b. Even if a is negative, the 
result of a mod b is nonnegative. However, in C++, if a is negative and b is positive, 
a%b is negative. Furthermore, C++ allows b to be negative, or even zero! Use the 
following program to explore the result of a%b various choices of a and b. 





Program 2.5: A program to explore C++’s mod operation. 


#include <iostream> 
using namespace std; 


[xx 
x A program to investigate the behavior of the mod (%) operation. 


*/ 


auiote. imnysysiiai(()) if 
atione: yelp loys 
Cour. << “Enter the first number ==>. "5 


Calin, SS .E1p 


cout << "Enter the second number -—> "; 
@alin “2 59 
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Cone, K< ~i K< Wa Wee lg) xe erly KS. SiaveliLp 


return 0; 


} 








Line 11 types the words Enter the first number --> onto the screen. No- 
tice that we did not include an endl, so the computer does not move the cursor to a 
new line. 

Line 12 introduces the cin object. The statement cin >> a means read a value 
from the computer’s keyboard and save the result in the variable a. 


C++ provides an interesting combination of arithmetic operations and assignment. 
The statement x += 4; is an abbreviation for x = x+4;—increase the value held 
in x by 4. All of the usual arithmetic operations can be used in this combined syntax. 





| Statement | Meaning 
x += y; xX = XTY; 





x —= Yi x = X-Yy; 
Rok V G x = X*y; 
x /= yi; |x = x/y; 
X S= Y; xX = xXSY; 











In computer programs, one frequently wishes to increase or decrease an integer 
variable by 1; this happens when we want to consider successive elements of an array 
or when counting. A special syntax can be used in place of x += 1 and x -= 1. 
The expressions x++ and ++x both increase x by one, and x-— and --x both decrease 
x by one. We call ++ and —- the increment and decrement operators, respectively. 

The expressions x++ and ++x are not exactly the same. We explain the difference 
here because you might need to understand someone else’s program that relies on 
this difference. You should not take advantage of the difference between ++x and 
x++. Doing so makes your code more confusing, and the most likely victim of that 
confusion will be you. So read the next portion if you are curious, or you can safely 
skip ahead (past the material enclosed between the double lines) to the discussion on 
exponentiation. 








With that admonishment firmly in place, here is the difference between x++ and 
++x. Although both of these expressions increase the value of x by one, the result of 
this expression is, in the first case the old value of x and in the latter case, the new 
value of x. For example, consider this code. 


int x,y; 
x = 10; 
y = Xt+t; 


cout << y << endl; 


int a,b; 
a = 10; 
b = ++ta; 


cout << b << endl; 


eCerINDUNFWN KE 
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The statement y = x++; assigns the old value of x to y,so cout << y << endl; 
types 10 on the console. On the other hand, the statement b = ++a; assigns the new 
value of a to b, so the statement cout << b << endl; types 11 on the console. 
The two versions of ++ are called preincrement (for ++x) and postincrement (for 
x++). Similarly, the two versions of -- are called predecrement and postdecrement. 
And, as you might suspect, the name of the language is inspired by the ++ operator 
as C++ is an extension of the C language. 
Do yourself a big favor. Do not write code that depends on this difference! Instead, 
write your program this way. 
int: «7y} 
x = 10; 
Y= Xi 
xtt+; 
cout << y << endl; 


int a,b; 
a = 10; 


b=a; 
cout << b << endl; 








Missing thus far from our discussion is exponentiation. There is no exponentiation 
operator in C++. Rather, one may use the pow procedure. To do so, one needs to 
load the cmath header file using the following preprocessor directive. 


#include <cmath> 


With this in place, you can compute a” with the expression pow (a,b). 

The cmath header defines a number of standard mathematical functions and con- 
stants. For example, exp is the usual e* function and M_PI gives the value! of 2. A 
classic problem (that one ought to solve without a computational aid) is to determine 
which is greater: e” or 2°. The following program settles the issue. 





Program 2.6: A program to calculate e” and 7°. 
#include <iostream> 
#include <cmath> 
using namespace std; 


[xx 
x Which is larger, pi to the e or e to the pi? We calculate both to 
* Srict oh 2 


*/ 


int main() { 
double e = exp(1.); 
double pi = MPI; 


'The symbol M_PI is not completely standardized. If your compiler complains that M_PI is undefined, 
add the line const double MPI = 3.14159265358979; to the beginning of your program. 
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Come << VE ie ihe jon ae Y << Exgo(jot)) << Surelils 
Come «<< Yor ie tlie G ae Y << joor(joi, 6) << Gmclils 


} 





Here is the output of the program. 





e to the pi is 23.1407 
pi to the e is 22.4592 








2.6 Comparisons and Boolean operations 


C++ provides comparison operators for testing numbers for equality and order. 
Each of these operators results in a bool. In this chart, x and y are variables, and x 
and y are their respective values. 





Expression | Result 











x == y true iffx=y 
x l= y true iffx Ay 
x<y true iff x < y 
x <= y true iff x < y 
x > y true iffx > y 
x 





>= y true iff x > y 





Boolean values can be combined with the standard logical operations. In the fol- 
lowing chart x and y are of type bool, and x and y are their values. 








Expression | Description 

Ix ax, Le., not x 

x && Y xVy, 1.e., logical and 
x ll y x/y, Le., logical or 

x 7 y xVy, ie., exclusive or 














These logical connectives are often used in conjunction with comparison operators 
in an expression such as 


( (x == y) && (y <= z) ) 


which evaluates to true if and only if x = y < z. Although the following is syntacti- 
cally correct, 


xX == y <= Zz 


it is not equivalent to x = y < z. Here one of x == yory <= z is evaluated first 
and then that results in a bool value. Unfortunately, bool values are convertible 
to integers, so the next comparison can take place. The expression x == y <= zis 
poor programming because it is not clear to the reader which comparison is evaluated 
first. (C++ has specific rules for this, but you should not rely on them.) Furthermore, 
the use of a bool as a numeric type is a sneaky trick, and sneaky tricks (regardless 
of how clever they may be) make code confusing and hard to understand. 
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2.7 Complex numbers 


C++ handles complex numbers nearly as easily as real numbers. Although the 
real types such as double are part of the C++ core, the complex type requires the 
inclusion of a header file and a slightly different syntax for variable declaration. 

First, because complex numbers are not part of the C++ core, we need to issue the 
preprocessor directive #include <complex>. 

Second, we have some choices on what sort of complex numbers we want. For 
example, we may want complex numbers in which the real and imaginary parts are 
of type float, or for greater accuracy, both of type double. On the other hand, we 
may be interested in working with Gaussian integers, in which case we want the real 
and imaginary parts to be of type int or long. Fortunately, all these choices are 
available to us. Here is how we declare variables: 


complex<double> z; // z’s real and imaginary parts are of type double 
complex<long> w; // w is a Gaussian integer 


Next, we need to be able to assign complex values to these newly declared com- 
plex variables. We do that as follows. 


Z = complex<double> (4., -0.5); // z is set to 4-0.5i 
w = complex<long> (6,2); // wis set to 6+2i 


Recall that in order to convert (cast) an int into a double, we used an expression of 
the form double (x) (where x was a variable of type int). The same idea applies 
here. To create a complex<double> we use the type name, but this time with two 
arguments, as in complex<double>(4.,-0.5). 

Typing complex<double> repeatedly can be annoying. Fortunately, C++ enables 
us to create an abbreviation. The statement 


typedef complex<double> C; 


defines the symbol c as a substitute for complex<double>. Once we have created 
this abbreviation, to declare a variable to be of type complex<double> we only 
need to type C z; and z has the desired type. To assign z a value, we can simply 
write z = C(6,-3); and now z has the value 6 — 3. 

Complex variables are printed on the screen as ordered pairs. If z has value 6 — 31, 
then cout << z << endl; prints (6,-3) on the computer’s screen. 

The following program illustrates these ideas. Note the unusual way in which we 
extract the real and imaginary parts of a complex variable (lines 26—27). It is too 
soon for us to explain this unusual syntax, but all is revealed in time. 





Program 2.7: A program to demonstrate C++’s ability to handle complex numbers. 


#include <iostream> 
#include <complex> 
using namespace std; 


CAA NDUNAPWNK TUAANARDMN 
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[*x* 
x A program to illustrate the use of complex numbers. 


*/ 


typedef complex<double> C; 


int main() { 
CG s(Sea) p // define x = 3+4i 
CG. 2s // declare z to be complex 
BS IC(2e WD) a ff assigin 2 = Oe7s 
al (O, sd) es // define i = sqrt (-1) 


coun << VA = Y << 4 << Giaclils 


Come «<< We = Y << oe << Giaiclils 

(eleiphe:, Ke Wessel Gide ane {ahoolhA 

coun << "see = Meek ex <a endl 

Goi Ke Was = Ww KK piss ax Ginclily 

Zn eeu tems GA peeks 

cout << "Now z = " << z << endl; 

Come << Wine: seaail joeucie. Ose ~ as Ye oz ieeyeull () 


<< " and the imaginary part is << z.imag() << endl; 


return 0; 





The output of this program follows. 





Zz (2,7) 

x = (3,4) 

zt+x = (5,11) 

Z*X = (-22,29) 
z/x = (1.36,0.52) 
Now z = (5,-4) 


The real part of z is 5 and the imaginary part is -4 





If you plan to work with complex numbers, the typedef abbreviation is conve- 
nient, as is defining the variable i to be /—I. A convenient way to do this is to 
create your own header file to #include at the start of your program. The name of a 
header file that you create is some base name of your choosing plus a .h extension. 
For example, you could name the header file my_complex.h, but my preference is 
complexx.h with the extra x for extension. 

Here is the complexx.h header file. 





Program 2.8: A header file, complexx.h, containing convenient definitions for 
working with complex numbers. 

[*x* 

x @file complexx.h 

x @brief A header file that adds convenient extensions for working 

* with complex numbers. 


*/ 


CoCmArAIADNFWNK TOKO ON 
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#ifndef COMPLEXX_H 
#define COMPLEXX_H 


#include <complex> 
using namespace std; 


[xx 
x We define C to be an abbreviation for complex<double>. 
x/ 

typedef complex<double> C; 


/[*x* 

x We define i to be a constant equal to sqrt(-1), i.e., C(0.,1.). 
x/ 

come C sl = CWO. iaje 


fendif 





When we want to use this header file, we employ a slightly different version of the 
#include directive. We write this at the start of our program: 


#include "complexx.h" 
We can now use C and i as desired. 


There’s a fair amount going on in the complexx.h file, but the heart of the mat- 
ter can be found on lines 16 and 21 where we define c to be an abbreviation for 
complex<double> and i to be a constant equal to \/—I. 

Line 21 contains a new C++ keyword, const. By declaring i to be of type 
const C we are saying two things. First, i represents a quantity of type c (which, in 
turn, means complex<double>). Second, i cannot be changed later in our program. 

Because i is declared outside any procedure (e.g., it is not enclosed between the 
curly braces of main () ), itis a global constant. The use of global constants is good. 
If your work makes extensive use of the golden mean, @ = 5(1 + /5), you could 
create a header file containing the following line. 


const double phi = (1. + sqrt(5.))/2.; 


Side comment: It is possible to create global variables, but this is a bad practice 
that should be avoided if at all possible. The problem is that one part of your program 
might modify a global variable causing unexpected behavior later in another part of 
your program. A common source of confusion and bugs in computer programs are 
the side effects procedures might have. We try to rein these in as much as possible. 
Global variables are antithetical to this effort. 

There are a number of other parts of complexx.h that we need to explain. Let’s 
work through them one at a time. 


e Lines 1-5 are a comment. Without going into detail, these comments give a 
description of what this file does. The @file and @brief are instructions 
for a program called Doxygen that we describe later. Suffice it to say that 
by including these markers here, the Doxygen program can use comments 
like this to create beautiful Web pages that you can use to look up what your 
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program does. (The extra « on line | is a signal to Doxygen that this is a 
comment it should read.) 


Lines 7, 8, and 23 are a safeguard against accidental double inclusion. It is 
easy to #include header files more than once. How can this happen? Some 
day you might create a header file for handling Mobius transformations, that 
is, functions of a complex variable of the form f(z) = (az+b)/(cz+d). In 
your header file mobius.h you need to define various quantities as complex, 
so you start with the directive #include "complexx.h" to be sure that Cc 
and i are defined before you get started. 


Now in the main program you might write this: 


#include "complexx.h" 
#include "mobius.h" 


Without the double-inclusion safeguards, this would cause the two statements 
typedef complex<double> C; and const C i = C(0.,1.); to be in- 
serted twice into your program. The compiler would then complain about this 
and refuse to compile your program. 


There are two solutions to this problem. A bad solution is to require you to 
remember which of your various header files already includes which other and 
make the programmer (you) responsible for avoiding double inclusion. 


The better solution is to build in a mechanism in the header file that prevents 
double inclusion. Here is how this mechanism works. 


Line 7 begins with the directive #ifndef. This is not a C++ statement, but 
rather an instruction to the preprocessor; it stands for “if not defined.” If what 
is not defined? If the symbol COMPLEXx_H is not defined, then we should do 
what follows up to the matching #endif on line 24 (at the end of the file). 





If the symbol COMPLEXX_H is not yet defined, we include everything in the 
file. But if the symbol COMPLEXx_H is already defined, we skip everything 
through to the #endif. 














Suppose COMPLEXX_H is not defined (and it won’t be when we first set out), 
and we next come to line 8 which reads #define COMPLEXX_H. This line 
defines the symbol COMPLEXxX_H, although it does not specify any particular 
value for the symbol. (We don’t care whether COMPLEXX_H has a value; we 
just want to know whether it is defined.) 











Suppose we try to #include "complexx.h" a second time. On the first 
pass through complex.h, we executed the directive #define COMPLEXX_H. 
Thus, on this second pass, when we reencounter #ifndef COMPLEXX_H the 
preprocessor notes that COMPLEXX_H is defined and then skips everything in 
the file until the matching #endif. 











The rest of the file is easier to understand. We need to include the C++ header 
file complex in order to use complex<double> later. We need the statement 
using namespace std; so the definitions in <complex> are available. 
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The comments before lines 16 and 21 document how c and i are defined. 
These comments can be processed by Doxygen. 





2.8 Naming variables 


C++ allows you to name your variables more or less whatever you like. The name 
should begin with one of the 26 letters (lower or upper case). After that, it may 
contain letters, digits, or the underscore symbol _. 

Pick short, easily remembered names for your variables. For example, if your vari- 
ables are named center_x, center_y, and radius, it is instantly clear to anyone 
(especially yourself) what these variables hold. 

There are some obvious restrictions on your choice of names. You cannot use a 
C++ keyword as a variable name. So you cannot name your variables if or for 
or long; these already have meanings in C++. It’s not worth memorizing all of 
C++’s keywords. If you accidentally try to name a variable with one of C++’s more 
obscure keywords, the compiler will complain. Unfortunately, it won’t complain in 
a way that you like. For example, imagine you tried to declare a long variable to 
be named volatile (perhaps you are working with a chemist trying to model some 
nasty substance) like this: 


long volatile; 


It turns out the volatile is a C++ keyword (one that you do not need to know about 
for mathematical work). What you would like is an error message from the compiler 
that this is an illegal variable name. Here is what the compiler on my computer says 
about this line: 


warning: declaration does not declare anything 


Not particularly helpful, but at least the compiler did complain about the offending 
line. 

Try to develop a consistent style of variable names. I prefer to name variables 
beginning with lowercase letters. (Later, when we create our own types, I name these 
beginning with uppercase letters.) Multiword names either can use the underscore as 
a space (you cannot have a space or hyphen in a variable name) or use capital letters 
to show the start of each word. Some examples: 
left_end_point 
rightEndPoint 


geometric_mean 
upperBound 





Some people like to use all capitals for constants, for example, GOLDEN_MEAN. 











Variables may be declared anywhere you like as long as they are declared before 
they are used. 
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2.9 Exercises 


2.1 Consider the following program. 


22 


2.3 


2.4 


#include <iostream> 
using namespace std; 


int main () 
float x; 


ane 3 
double z; 


xX = 
y= 
z= 


35y 
x; 
yi 


{ 


cout << z << endl; 
return 0; 


What is printed to the screen (and why)? 


What is the output of the following program and which (if any) of the lines 
gives a result equal to 2 ze 


#include <iostream> 
using namespace std; 


int main () 


cout 
cout 
cout 
cout 
cout 


<< 
<< 
$< 
<X 
<< 


{ 
(4/3) * 
4x (10/ 
(4x10) 
(4/3) * 
(4./3) 


return 0; 


10 << endl; 
3) << endl; 
/3 << endl; 
10. << endl; 
*10 << endl; 


What is the output of the following program? How does C++’s % operator 
differ from the mathematical mod operation? 


#include <iostream> 
using namespace std; 


cout 


<< 


return 0; 


(-3) << endl; 
-3) << endl; 


Explain why the expression ’ 3’ ==3 is legal C++ and what it means. What 
value does this expression have? 
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Consider this program. 


#include <iostream> 
using namespace std; 
int main() { 


int a, b; 
a= 5; 
b = 10; 


cout << (a==b) << endl; 
cout << (a=b) << endl; 
cout << (a==b) << endl; 
return 0; 


This program gives the following output. 





10 





Explain. 


Write a program to explore division by zero. Include the cases 7 and i Con- 
sider the variants in which the numerator and denominator are float or int 
(or one of each). 


What is the output of this program? 


#include <iostream> 
using namespace std; 
int main() { 

int a = 10; 

a t= a; 

a *= a; 

cout << a << endl; 

return 0; 


All of the following are illegal names for variables in a C++ program. Explain 
what is wrong with each. 

(a) 2nd_coord 

(b) y-val 

(c) double 

(d) x:y_ratio 

(e) purpleé&orange 


(f) le-2 


Chapter 3 





Greatest Common Divisor 





3.1 The problem 


For integers a and b, the greatest common divisor of a and b is the largest integer 
d such that d is a factor of both a and b. The greatest common divisor is denoted 
gced(a,b). We say a and bare relatively prime provided gcd(a,b) = 1. In this chapter 
we develop many C++ concepts by studying a particular problem involving the gcd 
of integers. 

Here is the classic problem: Let n be a positive integer. Two integers, a and b, 
are selected independently and uniformly from the set {1,2,...,n}. Let py be the 
probability that a and D are relatively prime. Does lim,_... py, exist and, if so, what is 
its value? 

The computer cannot solve this problem for us, but it can help us to formulate 
a conjecture. We try a number of approaches including exhaustive enumeration, 
generating pairs of numbers at random and recording the results, and the use of 
Euler’s totient. 

The first order of business, however, is to develop a procedure to compute the 
greatest common divisor of two integers. 





3.2 A first approach 


In this section we develop a correct, but highly inefficient, procedure for calculat- 
ing the greatest common divisor of two integers. Our goal is to introduce a number 
of C++ concepts as well as to create the gcd procedure. This procedure takes two 
integers and returns their greatest common divisor. Later, we replace this inefficient 
procedure with a much more efficient method. 

Before we begin, however, we need to address a bit of terminology. Mathemati- 
cians and computer programmers use the word function differently. A mathemati- 
cian’s function assigns to each value x a unique value y = f(x). Suppose we calculate, 
say f(8) and the result is 17. Then if we calculate f(8) a few minutes later, we are 
guaranteed that the result is still 17. 
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By contrast, for a C++ programmer, it is natural that a function might return dif- 
ferent values (even with the identical arguments) at different times! This is because 
C++ functions can access data beyond their arguments; for example, there is a C++ 
function that reports the current time. Clearly, the value of this function changes 
from one minute to the next. 

As a mathematician, my bias is, of course, for the mathematical use of the word. 
Therefore, in this book, we use a different word for C++ functions; we call them 
procedures. This nomenclature ought not upset our computer science colleagues, 
but when you read other books or documentation about C++ procedures, be aware 
that they are likely to be called functions. (Some books may refer to methods and we 
introduce that terminology later.) 

With issues of nomenclature behind us, we now develop a procedure to compute 
greatest common divisors. 


We need to name the procedure. We could name it greatest_common_divisor, 
but there is no loss of clarity in simply naming it gcd. We want gcd to accept two 
arguments (inputs) of type long and return an answer that is also of type long. 

The code for the gcd procedure is written in two files named gcd.h and gced.cc. 
The header file, gcd.h, is used to describe the procedure (both in C++ and in En- 
glish comments). The file gcd. cc contains the actual instructions for calculating the 
greatest common divisor. 

This organization is similar to declaring versus assignment variables. The decla- 
ration announces the variable’s type and the assignment gives the variable a value. 
Likewise, the header file announces the type of the procedure (two long inputs and 
return a long) and the .cc file gives the actual instructions to be carried out. 

The file gcd.cc does not have a main() procedure; the main() is found in an- 
other file. The latter file includes the directive #include "gcd.h". 

The first gcd algorithm we present is terribly inefficient. When we develop a 
better algorithm, we replace the file gcd.cc, but the file gcd.h does not change. 
The file gcd.h looks like this. 





Program 3.1: The header file gcd.h. 


#ifndef GCD_H 
#define GCD_H 


[xx 

* Calculate the greatest common divisor of two integers. 
* @param a the first integer 

* @param b the second integer 

* @return the greatest common divisor of a and b 


x/ 
long gcd(long a, long b); 


#endif 





Line 11 is the most important line of this file. The statement 
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long gcd(long a, long b); 


declares gcd to be a procedure. This procedure takes two input arguments (named a 
and b) that are both of type long. The first long on this line (to the left of gcd) is 
the return type of the procedure; this indicates that the procedure returns a value of 
type long. 

Other features of this file: lines 1, 2, and 13 are the mechanism to prevent double 
inclusion (see the discussion on page 26). Lines 4-9 are a description of the gcd 
procedure. This description includes a sentence that explains what the procedure 
does, an explanation of the parameters passed to the procedure, and an explanation 
of the value returned by the procedure. The tags @param and @return are read by 
Doxygen to produce a nice Web page for this procedure. 


We are ready to get to work on the file gcd.cc. This file has the following struc- 
ture. 


#include "gcd.h" 


long gcd(long a, long b) { 
return d; 


} 


The definition of the gcd procedure looks nearly identical to the declaration in the 
header file. The semicolon on line 11 of gcd.h is replaced by an open brace. The 
open brace is followed by the instructions to calculate the greatest common divisor 
of a and b, and that value eventually ends up in a variable named d. The return d; 
statement causes the value in d to be the “answer” returned by this procedure. 

Our strategy is to test successive integers to see if they are divisors of a and b, and 
keep track of the largest value that divides both. 

There are a few things we need to worry about first. 


e@ What happens if the gcd procedure is given negative values for a or b? 


There is nothing wrong with allowing a or b to be negative. After all, 


gced(a,b) = gced(—a,b) = gced(a, —b) = gced(—a, —b). 


e@ What happens if one (or both) of a or b is zero? If only one of these is zero, 
then there is no mathematical problem because gcd(a,0) = |a| provided a 4 0. 


However, gcd(0,0) is undefined. We need to decide what to do in this case. 
We could have the program immediately stop (this is done by the statement 
exit (1);). A better solution, however, is to print a warning message and 
return a value, say zero. 


We need to revise the documentation in gcd.h to reflect this. 
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Program 3.2: Revised documentation for gcd in the header file gcd.h. 


Calculate the greatest common divisor of two integers. 
Note: gcd(0,0) will return O and print an error message. 
@param a the first integer 

@param b the second integer 

@return the greatest common divisor of a and b. 


Paria LE, ali, Som i Se 





Now we work on gcd.cc. The file begins as follows. 





Program 3.3: Beginning of the file gcd.cc. 
#include "gcd.h" 
#include <iostream> 
using namespace std; 


Once cca @honicurch, lon Gaso)) ma, 


// if a and b are both zero, print an error and return 0 
if ( (a==0) && (b==0) ) { 
cerr << "WARNING: gcd called with both arguments equal to zero." 
<< endl; 
return 0; 


} 





We require #include <iostream> on line 2 because we may need to write an 
error message (in case gcd (0,0) is invoked). Line 5 starts the definition of the gcd 
procedure. 

The first thing we check is if both arguments are equal to zero; this occurs at line 8. 
The general structure of an if statement is this: 
if ( condition ) { 


statements; 


} 


If the condition (an expression that evaluates to a boo1) is true, then the statements 
in the enclosing braces are executed. Otherwise (the condition is false), all the state- 
ments in the enclosing braces are skipped. 

For our program, if both a and b are zero, then the condition is true and the two 
enclosing statements are executed. The first writes a warning message to an object 
named cerr. The cerr object is similar to the cout object. It would not have been 
a mistake to use cout here instead. However, computers provide two output streams, 
cout and cerr, and both write to the screen. The cout is usually used for standard 
output and cerr for error messages. 

The second statement controlled by this if is return 0;. When this statement 
is executed, the procedure ends and the value 0 is returned; the rest of the program is 
not executed. 


Next, we ensure that a and b are nonnegative. 
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Program 3.4: Ensuring a and b are nonnegative in gcd.cc. 


// Make sure a and b are both nonnegative 
ake (ax@)y 
a= -a; 
} 
aie {(lox<)) 
Io) = lo}H 
} 





The code is reasonably straightforward. If a is negative, it is replaced by —a; and 
likewise for b. However, there is something to worry about. Do these statement have 
a side effect? We are changing the arguments to the gcd procedure. Does this change 
the values of a and b in the procedure that called gcd? 

The answer is that no change is made to any values outside the gcd procedure; 
there are no side effects. The reason is that when another procedure (say, main () ) 
calls gcd, the arguments are copied to a and b. We say that C++ procedures call by 
value; the arguments are copies of the originals. For example, suppose the main () 
contains this code: 
long x = -10; 


long y = 15; 
cout << gcd(x,y) << endl; 


When gcd is invoked, the computer sets a equal to —10 and b equal to 15; the values 
a and b are private copies of these values. Eventually gcd reaches line 16 where it 
replaces a with —a (1.e., sets a to 10). However, the original x in main is unaffected 
by this. 


Next we get to the heart of the matter. We test all possible divisors from | to a 
and see which divides both a and b. There’s one slight mistake, though. If a is zero, 
then the answer should be b. We treat that as a special case. Here is the last part of 
the program. 





Program 3.5: The last part of the gcd. cc program. 
// if a is zero, the answer is b 
Hie (el==0))) i 
repurnch; 


} 
// otherwise, we check all possibilities from 1 toa 
long d; // d will hold the answer 
for (long t=1; t<=a; t++) { 
if ( (aSt==0) && (b%t==0) ) { 


Ol ee 
} 


37 
38 


36 C++ for Mathematicians 


return d; 





Lines 23-25 handle the special case in which a is zero. After that, we declare a 
variable d to hold the answer. 

Lines 31-35 do the bulk of the work of this program. We begin with a new C++ 
keyword: for. The general form of the for statement is this: 
for( starting statement ; test condition ; advancing statement) { 


statements to be done on each iteration; 


} 


The starting statement is executed the first time the for statement is reached. In 
our case, the starting statement is long t=1;. This declares a new long integer 
variable named t and assigns it the value 1. 

Next the test condition is evaluated; if this condition evaluates to TRUE, the state- 
ments enclosed in the curly braces are executed. In our case, the test condition is 
t<=a;. As long as t is less than or equal to a, we do the statements enclosed in the 
curly braces. 

After the enclosed statements are executed, the advancing statement is executed; 
in our case, that statement is t++;. This means that t is increased by 1. 

Now the entire process repeats. For our example, t now holds the value 2. As 
long as this is less than or equal to a, the enclosed statements are executed. Then t 
is advanced to 3, then to 4, and so forth, until the test condition is FALSE. At that 
point, the for loop is exhausted and we proceed to the next statement after the close 
brace; in our example that’s at line 37 and the statement is return d;. 

In other words, the code 
for (long t=1; t<=a; ttt) { 


statements; 


} 


executes the statements between the curly braces a times with t equal to 1, then 2, 
then 3, and so on, until t equals a. 

This style of for statement is common in programs. Of course, we can use the 
for statement to step down through values as in this code: 
for (long s=n; s > 0; s--) { 


statements; 


} 


Alternatively, we could step only through odd values of the index: 


for (long j=l; 3 <= n; j += 2) { 
statements; 


} 


For our gcd procedure, letting t take the values, 1, 2, 3, and so on, until a is 
precisely what we want. For each value of t, we check if t is a divisor of both a 
and b. We do this with the conditional if ( (a%t==0) && (b%t==0) ). If this 
condition is satisfied, we update d to the current value of t, and this is what happens 
on line 33. 

After the loop is finished, the value held in d is returned. 





COANDUNFPWNKFK TO AANADUN FS wWN SE 


Greatest Common Divisor 37 


Now that our gcd program is finished, it’s time to try it out. In a separate file, that 
we name gcd-tester.cc, we write a simple main () procedure to try out our code. 





Program 3.6: A program to test the gcd procedure. 


#include "gcd.h" 
#include <iostream> 
using namespace std; 


/** 

* A program to test the gcd procedure. 
*/ 

int main() { 
lester eiploz 
COME GK WitinleSse ielovs: aalieshc. saibitloysie =e Wp 
Gali SS> Erg 
cout << "Enter the second number -—> "; 


Gim SS Ip 


Cour <2 "ine ged of" <a Seo! card Re ee i 
<< gcd(a,b) << endl; 
return 0; 








3.3 Euclid’s method 


The program we developed in Section 3.2 works, but it is a slow, inefficient algo- 
rithm. Suppose we want to calculate the greatest common divisor of numbers that are 
around one billion? This is not too large for a long integer, but in order to find the 
answer, the trial-division algorithm runs for billions of iterations. There is a much 
better way that was developed by Euclid. 

The key idea is the following result. 


Proposition 3.1. Let a,b be positive integers and let c= a mod b. Then gcd(a,b) = 
gced(b,c). 


Proof. Let a,b be positive integers and let c= a mod J; that is, a= gb+c where 
g,c€ Zand0<c<b. 

Note that if d is a common divisor of a and D, then d is also a divisor of c because 
c=a-— qb. Conversely, if d is acommon divisor of b and c, then (because a = gb+c) 
d is also divisor of a. Hence the set of common divisors of a and b is the same as the 
set of common divisors of b and c. Therefore gcd(a,b) = ged(b,c). 














We use this to develop an algorithm. Suppose we want to find gcd(80,25). By 
Proposition 3.1, we calculate 80 mod 25 = 5 and so gced(80,25) = ged(25,5). To 
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find gcd(25,5), we again apply Proposition 3.1. Because 25 mod 5 = 0, we have 
gcd(25,5) = ged(5,0). At this point Proposition 3.1 does not apply because 0 is not 
positive. However, we know that gcd(5,0) = 5 and so we have 


gced(80,25) = ged(25,5) = ged(5,0) =5 


and we only needed to do two divisions (not 25 or 80). 
In this section we present two programs for computing the greatest common divi- 
sor by this method. Here is the first. 





Program 3.7: A recursive procedure for gcd. 


#include "gcd.h" 
#include <iostream> 
using namespace std; 


slomue; wejerel (lemme a, Ibeiave} 19) if 
// Make sure a and b are both nonnegative 
tf (a<0) a = =a; 
atic (ox<(0)) Tey = S109 


// if a and b are both zero, print an error and return 0 
if ( (a==0) && (b==0) ) { 
cerr << "WARNING: gcd called with both arguments equal to zero." 
<< endl; 
return 0; 


} 

// Tf b is zero, the answer is a 
if (b==0) return a; 

// If a is zero, the answer is b 
if (a==0) return b; 


long c = a%b; 


return gcd(b,c); 





Lines 7 and 8 ensure that a and b are nonnegative. We use a slightly different 
syntax for these if statements. When an if is followed by exactly one statement, 
the curly braces may be omitted. The single-line statement if (a<0) a = -a; is 
equivalent to this: 


if (a<O) { 
a= -a; 


Line 11 checks to see if the arguments are both zero; if they are, we issue a warning 
and return zero. 

Lines 18 and 20 check if one of the arguments is zero; if so, the other argument is 
the answer we desire. 

The real work of this procedure is on lines 22 and 24. If the program reaches 
line 22, then we know that both a and b are positive integers and Proposition 3.1 
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applies. We calculate c to be a mod b, so the answer to this problem is gcd (b,c) 
and we return that. 

The question is: How is gcd (b,c) computed? The answer is that the gcd pro- 
cedure calls itself. This is known as recursion. If we call gcd (80,25), then when 
we reach line 24, c holds the value 5. At this point we issue a call to gcd (25,5). 
The previous call to gcd (80,25) goes “on hold” pending the result of gcd (25,5). 
When this second invocation of gcd reaches line 24 we have a equal to 25, b equal to 
5, and c equal to 0. A third call to gcd is generated at this point requesting gcd (5,0) 
and the second call is also placed on hold. During the call to gcd (5, 0), we come to 
line 18 (because b==0 evaluates to TRUE) and so 5 is returned. This is passed back 
to the second and then to the first call to gcd and the final answer, 5, is returned. 

Recursion is a powerful idea. When it applies, such as in this case, it can make 
for particularly simple code. The primary danger in using this technique is infinite 
recursion: if the program does not check adequate boundary conditions, it may run 
forever without returning an answer. This is akin to neglecting the basis case in a 
proof by induction. 

A classic example of recursion is a program to calculate factorials. Here is the 
general idea presented in an incorrect program. 
long factorial(long n) { 


return nxfactorial (n-1); 


} 


To calculate factorial (5) the computer makes a call to factorial (4) which (if 
all goes well) returns the value 24. We then multiply this by 5 to get our answer. 
The mistake, however, is that factorial (4) calls factorial (3) which calls 
factorial (2), and so on forever. We need to catch this process someplace, and 
the right place is when n is zero. 
Here’s a better version. 
long factorial(long n) { 
if (n==0) return 1; 


return nxfactorial (n-1); 


} 


This gives the correct result for factorial (5), butis not entirely free of the infinite 
recursion trap. Figure out for yourself the problem and what you can do to address 
it. (See Exercise 3.2.) 


Program 3.7 is a perfectly good, efficient gcd procedure. At this point, it would be 
proper to move on to the problem at hand (described at the beginning of this chapter). 
However, it is possible to make the program slightly more efficient and, in so doing, 
we can study another C++ feature: while loops. 

There are some minor inefficiencies in Program 3.7. The tests to ensure that a and 
b are nonnegative and not both zero are run at every iteration. One can prove, how- 
ever, that we do not need to worry about this in the embedded calls to gcd. The extra 
tests are performed unnecessarily. Also, the computer needs to do a modest amount 
of work every time a new procedure is called. To calculate the greatest common 
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divisor of two large numbers may result in dozens of calls to gcd. This overhead is 
not a serious problem, but if we plan to call gcd repeatedly, small improvements are 
worthwhile. 

We now present another version of the gcd procedure that does not use recursion. 





Program 3.8: An iterative procedure for gcd. 


#include "gcd.h" 
#include <iostream> 
using namespace std; 


Honcciccs@longpetch, selon ca) are, 
// Make sure a and b are both nonnegative 
LE (as0) a) = Say 
ise (cx<@))) Io = Slo 


// if a and b are both zero, print an error and return 0 
if ( (a==0) && (b==0) ) { 
cerr << "WARNING: gcd called with both arguments equal to zero." 
<< endl; 
return 0; 


long new_a, new_b; // place to hold new versions of a and b 


/* 
* We use the fact that gcd(a,b) = gcd(b,c) where c = a%b. 
x Note that if b is zero, gcd(a,b) = gcd(a,0) = a. If a is zero, 
* and b is not, we get a%b equal to zero, so new_b will be zero, 
* hence b will be zero and the loop will exit with a == 0, which 
* is what we want. 
x/ 
while (b != 0) { 
new_a = b; 
new_b = a%b; 
a new_a; 
b = new_b; 


return a; 





The beginning of this program is the same as Program 3.7; we make sure the 
arguments are nonnegative and not both zero. 
At line 17 we declare two new variables: new_a and new_b. The idea is to let 


ad <b and b' —amodb 


and to continue with a’ and b’ in lieu of a and b. We keep doing this until b reaches 
zero, and then a will hold the answer. For example, starting with a = 80 and b = 25, 
we have this: 
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Iteration 1] 2 |3 
value of a | 80 | 25 | 5 
value of b | 25 | 5 | 0 























These steps take place on lines 27-33. The control statement is while. The 
general form of a while statement is this: 


while (condition) { 
statements to perform; 


} 


When a program encounters a while statement, it checks to see if condition is TRUE 
or FALSE. If condition is FALSE, it skips all the statements enclosed in the curly 
braces. However, if condition is TRUE, then the statements inside the braces are 
executed and then we start the loop over again, checking to see if condition is TRUE 
or FALSE. 

In this manner, the loop is executed over and over again until such time as the 
condition specified in the while statement is FALSE. 

This is precisely what we need here. As long as b is not zero, we replace a and b 
with b and a%b, respectively. We enlist the help of the temporary variables new_a 
and new_b to do this. 

When the while statement terminates, a holds the greatest common divisor of the 
original a and b, and so we return that at line 35. 

It is interesting to note that we do not need two temporary variables for the while 
loop. The following works as well. 


while (b != 0) { 
new_b = a%b; 
a=b; 
b = new_b; 


} 


Although this is correct, it is more difficult to understand than the while loop in 
Program 3.8. The slightly more verbose version shows clearly how a and b are 
updated from the previous values of a and b. Clarity is often preferred to cleverness 
because clarity is more likely to be correct. 





3.4 Looping with for, while, and do 


We have introduced two of C++’s looping statements: for and while. Here we 
introduce you to a third: do. 

Recall that a while loop is structured like this: 
while (condition) { 


statements to execute; 


} 


42 C++ for Mathematicians 


The condition is tested before the enclosed statements are ever executed. If condition 
is FALSE, the statements will never be executed. Incidentally, the while structure 
can be replaced by a for loop as follows. 

for(; condition; ) { 


statements to execute; 


} 


The starting and advancing statements are missing, so they have no effect. We men- 
tion this mostly as a curiosity; the while version is preferable because it is clearer. 


Sometimes you may find that the condition you want to check doesn’t make sense 
until some series of instructions has been performed at least once. For example, a 
program might read in data from a file and should stop reading when a negative value 
is encountered. We need to read at least one data value before the condition makes 
sense. 

For such situations, the following structure can be used. 
do { 


statements to execute; 
} while (condition); 


The statements to execute are performed at least once. At the end of the loop, the 
condition is checked. If it is TRUE, then we return to the start of the loop for another 
round; if the condition is FALSE, the loop is finished and control passes to the next 
statement after the loop. The do-while loop structure is not used as frequently as 
while and for loops. 


There are two special statements that can be used to modify the execution of a 
loop: break and continue. 

The break command causes the loop to exit immediately with control passing to 
the next statement after the loop. Consider this code. 
for (long a=0; a<100; att) { 

statement1l; 

statement2; 

if (x > 0) break; 

statement 3; 

statement4; 


} 


statement5; 


If after statement2 the variable x holds a positive quantity, we skip statement 3 
and statement 4, and go directly to statement5. 
The break command can be used with while and do loops, too. 


The continue command directs the computer to go to the end of the loop and 
then do what is natural at that point. Consider this code. 


for (long a=0; a<100; att) { 
statementl; 
statement2; 
if (x > 0) continue; 
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statement3; 
statement4; 
} 


statement5; 


In this case, all 100 iterations of the loop take place. However, if during some iter- 
ation, after we execute statement 2, we find x to hold a positive quantity, we skip 
both statement3 and statement4. At this point we increase a (because the ad- 
vancing statement is a++). If a is less than 100, another pass through the loop is 
performed. 





3.5 An exhaustive approach to the GCD problem 


It is now time to tackle the problem from the beginning of this chapter. Let 
Pn be the probability that two integers, chosen independently and uniformly from 
{1,2,...,n}, are relatively prime. 

The following program counts the number of pairs (a,b) with 1 < a,b <n that 
satisfy gcd(a,b) = 1 and divides by n?. 





Program 3.9: A program to calculate py. 


#include <iostream> 
#include "gcd.h" 
using namespace std; 


[** 
* Find the probability that two integers in {1,...,n} are relatively 
* prime. 


*/ 


int main() { 
long n; 
Come «<< Vingiceie im == Ys 
ehiin) D> ine 


long count = 0; 
for (long a=1; a<=n; att) { 
in@ie (ikem: lo=ile lose lorrar) ff 
it (GeCl(S,!)) == i) 
(CKOubioE SPAR 


} 


cout << double(count) / (double(n) * double(n)) << endl; 
return 0; 
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The code is straightforward. We ask the user to enter n and set a counter (named 
count) to zero. The main action takes place in lines 17-23. Two nested for loops 
run through all possible values of a and b with 1 < a,b <n. On each iteration, if a 
and b are found to be relatively prime, the counter is increased by one. 

At the end, we divide the counter by n* to get the probability. Because we want a 
floating point answer, we cast the appropriate terms into type double (see line 25). 


To run this program, we need to use three files: gcd.h, gcd.cc, and this file (let’s 
call it exhaust .cc). We can either load all three into an IDE or (on a UNIX system) 
save all three in a directory and compile with a command such as 


g++ gcd.cc exhaust.cc -o exhaust 
and the program is saved in a file named exhaust. (See Appendix A for more 


details.) 
Here is a typical run of the program. 





Enter n --> 100 
0.6087 





Thus, P100 = 0.6087. 
If we run the program for various values of n, we generate the following results. 


n| Pn 
100 | 0.6087 
500 | 0.608924 
1000 | 0.608383 
5000 | 0.608037 
10000 | 0.60795 
50000 | 0.607939 




















It appears that lim)... Dn exists and is converging to a value around 0.6079. It 
would be useful to extend this table further. However, the last entry in this table took 
along time for my computer to calculate. Is there a more efficient method? There is 
one modest modification we can make to the program. Notice that we are computing 
the same values twice in most instances. That is, we compute both gcd(10, 15) and 
gcd(15,10). We can make our program twice as fast by calculating only one of 
these. Also, we do not have to bother calculating gcd(a,a); the only instance in 
which gced(a,a) equals one is when a = 1. 

Here is the modified version of the program. 





Program 3.10: A slightly better program to calculate pp. 
#include <iostream> 
#include "gcd.h" 
using namespace std; 


[xx 
* Find the probability that two integers in {1,...,n} are relatively 
* prime. 


*/ 
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int main() { 
long n; 
Coe << Vinieeie i ==> Ye 
akin, SS ise 


long count = 0; 


for (long a=1; a<=n; att) { 
for (long b=at+1l; b<=n; bt+) { 
if (gcd(a,b) == 1) { 
GOwiiessee 
} 
} 
} 


COUnEN— ma 5G O Un tamale 


cout << double(count) / (double(n) * double(n)) << endl; 
return 0; 





Notice that the second for loop (line 18) begins with b=a+1, so the inner loop 
runs from a+1 up to n. Thus the program calculates gcd(5, 10), but not gcd(10,5). 
We need to double count at the end to correct. Also, we do not calculate gcd(t,t) 
for any t, so we add | to (the doubled) count at the end to correct for that. These 
corrections are on line 24. 


In the following chapters, we approach the problem using two other methods: a 
Monte Carlo randomized algorithm (giving us an opportunity to learn about random 
numbers in C++) and a more intelligent exhaust using Euler’s totient @ (giving us 
an opportunity to learn about arrays). However, before we move on to those other 
approaches, we make our gcd procedure better still and use that opportunity to learn 
additional C++ features. 





3.6 Extended gcd, call by reference, and overloading 


The Euclidean algorithm can be used not only to find the greatest common divisor 
of two integers a and b, but also to express the gcd as an integer linear combination 
of a and b. That is, if a and b are integers (not both zero) then there exist x,y € Z 
such that ax + by = ged(a,b). 

Our goal is a procedure that can be called like this: 


d = gcd(a,b,x,y); 


where a,b are the numbers whose gcd we desire, d is gcd(a,b), and x,y have the 
property that d = ax+ by. At first glance this appears impossible for two reasons. 
First, we already have a procedure named gcd. Shouldn’t we name this something 
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else (such as extended_gcd)? Second, we can pass values to a procedure in its list 
of arguments, but the procedure cannot change the value of the arguments. This fact 
is known as call by value and was discussed earlier in this chapter (see Section 3.2). 
The good news is that neither of these is a significant hurdle. 

First, two different procedures may have the same name, but there is a caveat: The 
procedures must have different types of arguments. For example, suppose we want 
to create procedures for (a) finding the slope of a line segment from the origin to a 
given point and (b) finding the slope of a line segment joining two given points. In 
some programming languages, you would be required to give these different names; 
in C++, we may name them both slope. The declarations for these procedures 
(which we put in a header file named, say, slope .h) are these. 


double slope(double x, double y); 
double slope(double x1, double yl, double x2, double y2); 


The first is for the origin-to-slope version of the procedure and the second for the 
point-to-point version. Because the first takes two double arguments and the sec- 
ond takes four double arguments, the C++ compiler recognizes these as different 
procedures. 

The definitions of the procedures (which we place in a file named slope. cc) look 
like this: 
double slope(double x, double y) { 


return y/x; 


} 


double slope(double x1, double yl, double x2, double y2) { 
return (yl-y2) /(x1-x2); 
} 


When we use the same name for different procedures, these procedures ought to 
be closely related and serve essentially the same purpose. 

We mathematicians often use the same symbol for two closely related (but differ- 
ent) objects. For example, if we have a function f : R — R, then f(x) only makes 
sense when x is a real number. However, we often extend this notation. If A C R, 
then f(A) (same f) means {f(x):x€ A}. 

In C++, we refer to this ability to name different procedures with the same name 
as overloading. 


Second, it is true that C++ passes data to procedures using call by value; this 
means that the arguments to the procedure are copies of the original, and the invoked 
procedure cannot change the original values. For example, consider this procedure. 


void swap(long a, long b) { 
long tmp; 
tmp = a; 
a=b; 
b tmp; 
} 


The procedure’s return type is void. This means that the procedure does not return 
any value. The code in swap takes the values held in a and b and exchanges them. 
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If, when the procedure is called a holds 5 and b holds 17, then at the end, a holds 
17 and b holds 5. However, this procedure has no effect whatsoever on the calling 
procedure. Suppose the calling procedure contained this code: 


long a = 5; 

long b = 17; 

swap (a,b); 

cout << "a =" << a << endl; 
cout << "b=" << b << endl; 


The output of this would be as follows. 

“ 
A= oO 
b = 17 


There is a way to modify the procedure swap so that it is capable of modifying its 
arguments. Instead of passing the value of a to the procedure, we pass a reference to 
a. To do this, we add the character « to the end of the type name, like so: 








void swap(long& a, longé b) { 
long tmp; 
tmp = a; 
a=b; 
b tmp; 
} 


The «& does this: The argument a is a reference to a variable of type Long. Not only 
is a of type long, it is more than a copy of the long. This syntax means: instead 
of sending a copy of a to this procedure, send the variable itself (and not a clone). 
When a procedure receives a reference to a variable, it is working on the original and 
not a copy. 

With the rewritten swap procedure, the code 


long a = 5; 

long b = 17; 

swap (a,b); 

cout << "a = " << a << endl; 
cout << "b = " << b << endl; 


produces this output: 
a= 17 
b=5 


Call by reference is the mechanism we need so that the new gcd procedure can 
deliver three answers: the gcd returned via a return statement and the values x and 
y. The declaration for the procedure (which we add to gcd. h) looks like this: 








long gcd(long a, long b, long& x, long& y); 


A recursive approach to solving the extended gcd problem works well. Suppose 
we want to solve the extended gcd problem for positive integers a and b. We start by 
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solving the extended gcd problem for b and c where c = a mod b. Let’s say we have 
that solution so 
d = gcd(b,c) = bxo +. cyo 


for some integers xo, yo. We know that c is the remainder when we divide a by b; 
that is, 
a=qb+c 


where 0 < c <b. Writing c = a— qb we have 


d=bxy+cyo 
= bxo + (a—qb)yo 
= ayo + b(xo — gyo) 
=ax+by 





where x = yo and y = xo — qyo. 
These ideas form the heart of the recursion. To construct the procedure, we need 
to check special cases (a or b might be zero or negative). The code follows. 





Program 3.11: Code for the extended gcd procedure. 


long gcd(long a, long b, long &x, long &y) { 
long d; // place to hold final gcd 


// in case b = 0, we have d=/al, x=1 or -1, y arbitrary (say, 0) 
if (b==0) { 
ae, (ao) 4 
d = -a; 
oe Se ip 
y= OF 
} 
else { 
d =a; 
eel 
y= Og 
i 
return dj; 


} 


// if b is negative, here is a workaround 
if (b<0) { 

Cl = iecl(e5 9, a5 W) 8 

SAS EN 

return d; 


} 


// if a is negative, here is a workaround 
aie (ax@)) ff 

d = gcd(-a,b,x,y); 

236 ESE SOS, 

return d; 
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// set up recursion 
long aa = b; 

long bb = a%tb; 

long qq = a/b; 








long Xx, yy; 
d = gcd(aa,bb,xx,yy); 
x = yy; 
y = XX — Qq*yy; 
Fetus od; 
} 
3.7 Exercises 
3.1 Use the Euclidean algorithm to find d = gcd(51,289) and to find integers x 
and y so that d = 51x+ 289y. 
3.2 On page 39 we presented the following mostly correct procedure for comput- 
ing factorials. 
long factorial(long n) { 
if (n==0) return 1; 
return nxfactorial (n-1); 
} 
This procedure, however, still has a bug. What is it? 
3.3 Write a procedure to calculate the sign of its argument (the signum function). 
That is, your procedure should calculate 
+1 ifx>0, 
sgnx= 40 ifx=0, and 
—-1 ifx<0O. 
3.4 Write two procedures for producing the nth Fibonacci number when the num- 


ber n is given as input. In one procedure, use a for loop and produce the 
answer using iteration. In the second version, use recursion. The input argu- 
ment and return value should be type long. 


Use the following definition of Fibonacci numbers: Fo = Fi = 1, and F, = 
F,-1 + Fy_2 for all n > 2. 


Have your procedure return —1 if the input argument is negative. Don’t worry 
about overflow. 
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3.5 


3.6 


3.7 


3.8 
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Write a main to test the Fibonacci procedures you created in Exercise 3.4. Use 
it to evaluate Fo9, F39, and Fy. 


You should find that one version is much faster than the other. Explain why. 
Include in your explanation an analysis of how many times the recursive ver- 
sion of your procedure gets called in order to compute F,,. 


Write two procedures to calculate 


Note that for N large, this approaches € (2) = 27/6. 


The first procedure should calculate the sum in the usual order 





1+ 1 + Ms peer t a 
4 9 N2 
and the second should calculate the sum in the reverse order 
1 1 1 
eas (W—12 t taba t ds 


In both cases, use float variables for all real values. 


Evaluate these sums for N = 10° and report which gives the better result. 
(17/6 © 1.6449340668482264365.) 


Explain. 


Write procedures for converting between rectangular and polar coordinates 
named xy2polar and polar2xy. Invoking xy2polar(x,y,r,t); should 
take the rectangular coordinates (x,y) and save the resulting polar coordinates; 
(7,0) are r and t, respectively. The procedure polar2xy (r,t,x,y) ; should 
have the reverse effect. Be sure to handle the origin in a sensible manner. 


Of course, you need trigonometry functions to accomplish this task; consult 
Appendix C (especially Appendix C.6.1) where you can find useful functions 
such as atan2. 


Every positive integer has a multiple that, when expressed in base ten, is com- 
prised entirely of zeros and ones. Write a procedure to find the least multiple 
of n, the input parameter, of the required form. 


Warnings: If the long long type! is available on your computer, use it. The 
least multiple of the required form may be much larger than n. For example, 
what is the least multiple of 9 that contains only zeros and ones? What is the 
least such multiple of 99? 


Design your procedure to detect overflow and return —1 if it is unable to find 
the required multiple. 


'Or __int64. 
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3.9 Write a procedure to find the gcd of three integers of the form 


long gcd(long a, long b, long c); 


and an extended version of the form 

long gcd(long a, long b, long c, long& x, long& y, longé z); 

that returns d = gcd(a,b,c) and populates the last three arguments with values 
x,y,z such that ax-+ by+cz=d. 


You may use the gcd procedures developed in this chapter as part of your 
solution. 


Chapter 4 





Random Numbers 


In this chapter we discuss the generation random numbers in C++. The motivation 
is the problem introduced in Section 3.1: let p, be the probability that two numbers, 
sampled independently and uniformly from {1,2,...,”} are relatively prime. What 
can we say about py, as n — ©? 

In Chapter 3 we used direct enumeration to calculate p, for various values of n. 
However, as n approaches 100,000, the time for the computer to complete the cal- 
culation becomes excessive. This motivates us to find another attack. The approach 
we take is to sample pairs of integers in {1,2,...,n} at random and keep track of 
how often we find that they are relatively prime. To do this, however, we require a 
mechanism to generate (pseudo) random numbers. 





4.1 Pseudo random number generation 


We need a procedure that produces uniform random values in the set {1,2,...,n}. 
In this section, we develop such a procedure as well as a procedure to produce ran- 
dom real values in an interval. 

Before we begin, however, we need to understand that the computer does not pro- 
duce random values. Instead, it provides a pseudo random number generator. This 
is a procedure whose output looks random, but is actually deterministic. The sim- 
plest type of random number generator is a linear congruential generator or LCG 
for short. An LCG produces a series of integers xo,x1,x2,... by the following calcu- 
lation, 

Xnt1 = (aX, +b) mod c 


where a,b,c are fixed positive integers. The method is specified fully once we choose 
a value for xg. This first value is known as the seed. 

Pseudo random numbers produced by an LCG behave in some ways as uniform 
random values from {0,1,...,c — 1}, but there are problems. For example, by the 
pigeonhole principle, the sequence xo,x1,x2,... must repeat itself over and over. The 
hope is that by taking c sufficiently large, this is not an issue. 

A variety of more sophisticated pseudo random number generators have been pro- 
posed and implemented each with various advantages and disadvantages. The impor- 
tant point we need to keep in mind is that pseudo random numbers are not random, 
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so we need to be mildly skeptical of the results they suggest and careful in how we 
use them. 

Standard C++ includes the rand procedure for producing pseudo random num- 
bers. To use rand it is necessary to include the cstdlib library. A call to rand () 
returns an integer value between 0 and a constant named RAND_MAX (inclusive). The 
value of RAND_MAX is defined in the cstd1ib header file. A typical value is 27! — 1. 





4.2 Uniform random values 


It is possible to write programs so they call rand directly whenever a random 
value is required. However, it is a good idea to create our own procedures that serve 
as intermediaries between the program that requires a random value and rand. Why 
do we need a middle man? Here are three good reasons. 


e First, rand produces random values in a large discrete set. We might want a 
random integer in a smaller set (such as {0,1} if we want to simulate a coin 
flip) or we might want a uniform continuous value in the interval [0,1]. It is 
convenient to have procedures that do each of these. 


e Second, there are preferred methods to extract random values from rand. For 
example, if we want to simulate a coin flip, it is tempting to write code such 
as this: flip = rand()%2;. The problem is that the lowest-order bit of 
random values from a pseudo random number generator might not behave 
as you would expect. In the worst case, this last bit might simply oscillate 
between 0 and 1, and such coin flips do not look random at all. We create a 
better alternative one time and use that procedure henceforth. 


e Some day you might decide that you prefer a different random number gen- 
erator. Rather than editing all your programs to replace rand with the new 
procedure, you only need to rewrite the intermediaries. 


What do we want these procedures to do for us? We want to produce a random 
real value uniformly in the interval [0, 1], or more generally in an interval [a,b] where 
a,b € R. And we want to produce a random integer chosen uniformly from a finite 
set of the form {1,2,...,n}. 

Because all of these return a random value that is uniformly distributed over its 
domain, we name all three of these unif. This procedure name overloading is per- 
missible because the three versions have different type arguments. 





Program 4.1: Header file, uniform.h for procedures to generate uniform random 
values. 


#ifndef UNIFORM_H 
#define UNIFORM_H 
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[xx 
* Generate a random number between 0 and 1. 
* @return a uniform random number in [0,1]. 
*/ 

double unif(); 


[xx 
x Generate a random number in a real interval. 
* @param a one end point of the interval. 
* @param b the other end point of the interval. 
* @return a uniform random number in [0,1]. 
x/ 

double unif (double a, double b); 


[xx 

x Generate a random integer between 1 and a given value. 
* @param n the largest value this procedure can produce. 
i (Gage Ulieig: <2) Ulinaliriovei testolckoum wrellline mac (2 45 opin 

*/ 


long unif(long a); 


[xx 
* Reset the random number generator based on the system clock. 
*/ 


void seed(); 


fendif 





The three flavors of unif are declared on lines 8, 16, and 23. The first produces 
a uniform real value in the interval [0,1], the second generalizes this and produces 
a real value in an arbitrary interval [a,b], and the third produces an integer value 
uniformly in {1,2,...,n}. 

In addition, we have declared a procedure named seed on line 28. The purpose of 
seed is to initialize the random number generator from the system clock (more on 
this later). 


Let’s turn to implementing each of these starting with double unif(). Acallto 
rand () returns an integer between 0 and RAND_MAx. To convert this to a real value 
in [0,1] we simply compute rand() / double (RAND_MAX);. (See lines 7-9 of 
the file uniform.cc in Program 4.2 below.) 

Once we have the double unif() version written, we use it to write the second 
version. We simply multiply unif() by (b-a) and add a. See lines 11-13 in 
uniform.cc. 

For the integer version, we multiply the continuous unif () by a and convert to 
an integer. This gives a value in {0,...,a—1}, so we add 1 to place the value into 
the desired set. What if the user gives a negative or zero value for a? We have a 
choice as to handling these undefined situations. See lines 15-19 of uniform.cc to 
see our decision. 


Now we consider the seed procedure. Because rand (and the procedures that 
we wrote based on rand) returns an unpredictable stream of values, we might ex- 
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pect that the programs we write would behave differently every time we run them. 
Interestingly (and with good reason) this is not the case. Every time a program con- 
taining rand is run, the rand procedure gives the same sequence of pseudo random 
values. The reason is that the first time rand is invoked, it contains a fixed starting 
value called the seed of the random number generator. The reason this behavior is 
desirable is reproducibility. If you perform a computational experiment and wish to 
report it in a journal, it is important that others can run the same program as you and 
see the same results. 

However, there are times when this reproducible behavior is undesirable. For 
example, the motivating purpose of this chapter is to write code to generate many 
pairs of integers in a set {1,...,} to see how frequently they are relatively prime. 
We might want to run our program a few times with different streams of random 
values so we can compare results. 

The standard library (cst d1ib) provides the procedure srand that is used to set 
the seed used by rand. Calling srand(s), where s is a long integer, resets to the 
seed to s. We could ask the user to provide a seed value like this: 
long s; 
cout << "Enter a seed for the random number generator --> "; 


cin >> s; 
srand(s); 


Another solution, that is easier for the user, is to use the computer’s clock to provide 
the seed. As long as we don’t run the program twice in the same second, a different 
value is used for the seed. 

The header ct ime defines the procedure t ime. Calling time (0) returns the num- 
ber of seconds that have elapsed since a specific date and time (on many computers, 
that date and time is January 1, 1970 at 12:00 A.M. UTC). Our seed procedure sim- 
ply takes the value! returned by time (0) as input to srand. See lines 21-23 of 
uniform.cc. 





Program 4.2: Definitions of the unif procedures in uniform.cc. 


#include "uniform.h" 
#include <cstdlib> 
include <ctime> 
include <cmath> 
using namespace std; 


double unif() { 
return rand() / double (RAND_MAX) ; 
} 





double unif (double a, double b) { 
ieeieugian (Vol) seibioaie ()) ar le 


'To be precise, the procedure time returns a value of type time_t. Your compiler might require you 
to convert this to an unsigned integer before using it as an argument to srand. Replace line 22 with 
srand(unsigned (time (0) )); in this case 
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onicpinanta (Glo micurcy) ied 

aie (2 < 0) 2 = =p 

if (a==0) return 0; 
return long(unif()*a) + 1; 


void seed() { 
srand(time(0)); 











4.3 More on pseudo random number generation 


The integer version of unif used the expression long (unif()*a) +1 to pro- 
duce a random value in {1,...,a}. This is mildly convoluted because we have the 
additional call to the continuous version of unif that calls rand and divides by 
RAND_MAx. It is both simpler and more efficient simply to calculate 1 + rand() %a, 
but this latter approach is less reliable. 

The problem is that some older versions of the rand pseudo random number gen- 
erator are purported to be unreliable, and the lower-order bits of the values produced 
by rand do not behave well. One way to rectify this situation is to replace rand by 
a better procedure. 

To understand why the low-order bits of a random number generator might not 
be good approximations of randomness, we develop our own linear congruential 
generator (LCG) here. (And this gives us an opportunity to introduce additional C++ 
concepts.) 

Recall that an LCG produces a stream of values x9,x1,%2,... where 


Xnt1 = (aX, +b) mod c. 


The LCG is fully specified once we select values for a, b, c, and xo. For our example, 
we take 


a=17, b=3, c=64, and x=0. 


Suppose we call our procedure 1cg. Each time we call 1cg() it should return the 
next x; value in the sequence. However, for this the procedure 1cg needs to remem- 
ber the previous x value. The following code does not work. 
int lcg() { 

int state = 0; 

return (17x*xstate + 3) % 64; 
} 


Every time this procedure is called, it returns the value 3. We need to indicate that 
the variable state should only be initialized to zero the first time 1cg is called. 
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To do this, we declare the variable state to be static. The declaration looks 
like this instead: static int state = 0;. With this declaration, the variable 
state retains its value after the procedure 1cg ends. (Without the st atic modifier, 
the usual behavior is for variables to cease to exist once the procedure ends.) The 
variable st ate is initialized to zero only the first time 1cg is called. Henceforth, it 
retains the value it held when icg last terminated. 

The return statement is fine as written (return (17*state + 3) % 64) but 
there is a better way. The constants 17, 3, and 64 should be given names and declared 
at the beginning of the procedure. For a short simple procedure such as 1cqg, this is 
not an important issue. However, for more complicated procedures, giving constants 
specific names makes the program easier to read and easier to modify. Imagine that 
we write a program in which we are often reducing numbers modulo 64. Rather than 
explicitly typing 64 repeatedly in the code, we can define a variable named theMod 
set equal to 64 instead. Although typing theMod is longer than typing 64, if we ever 
want to change the program so that theMod is now, say, 128, we only have to change 
one line. The declaration of theMod looks like this: 


const int theMod = 64; 


The const modifier means that the procedure does not modify the value of theMod. 
This enables the C++ compiler to generate more efficient object code and prevents 
you from mistakenly putting theCode on the left-hand side of an assignment state- 
ment. 

Returning to the 1cg procedure, we declare three variables (named a, b, and c) to 
be type const int (see lines 12-14 of Program 4.3). The return statement is then 
return (axstate+tb) % c; which is easier to read. Later, if we wish to modify 
the 1cg program, we simply need to change the values we ascribe to a, b, or c at the 
top of the procedure. 


With the 1cg procedure written, we create a short main() to test it out. The 
main() calls lcg 20 times, reducing each return value modulo two. It then calls 
lcg another 20 times, reducing each of those results mod four. Here is the full 
program. 





Program 4.3: A program to illustrate the problem with lower-order bits in an LCG. 


#include <iostream> 
using namespace std; 


[xx 
* A sample linear congruential pseudo random number generator that 
% msc vias Welkues sha (OI, oo54.63:} a 
*/ 
migie kere) 1 
static int state = 0; 
const long a = 17; 


CONG Eee om mom —mOr 
COns tue Ongar 64; 


Random Numbers 59 


state = (axstatetb) % c; 
iMaSeiewe Sieeneeyp 


[*x* 
* This main calls lcg twenty times and prints out the value modulo 
* two, and then prints twenty more values taken modulo four. 

*/ 
aiiote. instal ()) 
Gomme << “VWwadues aerck Ze Ns 
ie@ye ((Gdiake Wee Wee70e icra) 4 
Gours << leg) se «<< Vp, 
} 
cout << endl; 
Coutts << se iVialiesemoceAc ste 
for (int k=0; k<20; k++) { 
Scouts ee Leos <c F s 
} 


cout << endl; 





return 0; 





When this program is run, the following output is printed on the screen. 





Values mod 2: 1 0 
Values mod 4: 3 2 





Clearly, the sequence of values we produce in this manner is far from random! 
However, we can change the way we extract zeros and ones from 1cg. Consider the 
following alternative main. 


int main() { 

cout << "Values mod 2: "; 

for (int k=0; k<20; k++) { 
double x = lcg() / 64.; 
cout << int(2*x) << ""; 

} 

cout << endl; 

return 0; 


Here we first produce a double value x in the range [0, 1) by dividing the output of 
lcg by 64. We then multiply x by 2 (so we are now somewhere in [0,2)) and then 
cast to type int (so the value is now either 0 or 1). Here’s the result. 





Values mod 2: 010111000010012011100 ] 





As you can see, the output appears, at least superficially, more random. 


COA NDNMNAP WNP TOAAAN FwWN 





RBPWwWNNYNNYNNNNNNNY WY 
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4.4 A Monte Carlo program for the GCD problem 


We now present a simple program to estimate p,. The user selects n (thereby 
specifying the set {1,2,...,n} from which pairs of integers are to be drawn) and the 
number of repetitions. The program generates the pairs, counts the number that are 
relatively prime, and reports the frequency. 





Program 4.4: A Monte Carlo approach to calculating py. 


#include "uniform.h" 
#include "gcd.h" 

#include <iostream> 
using namespace std; 


[xx 
* This main generates many pairs of values from the set {1,2,...,n} 
* and reports how often the pairs are relatively prime. The value n 
* and the number of pairs are specified by the user. 


*/ 
int main() { 
Long 17 VE weve Gu ic. alig “elner Sate (bp Apo 6 a piel 
long reps; // number of times we perform the experiment 
Long a,b; i GULLS Classen serio LilpAe 4 4 op i0t 
long count; // number of pairs that are relatively prime 
County — Or 
come «<< Vitijeeie in (ieoxiiu Gi ie ee ele SEic)) ==> We 


@alin SS inp 


cout << "Enter the number of pairs to sample --> "; 
cin >> reps; 


for (long k=1; k<=reps; k++) { 


a = unif(n); 
b = unif(n); 
if (gcd(a,b) == 1) ++count; 


} 
cout << count / (double(reps)); 


return 0; 





To begin, let’s run the program with n = 1000 for 10,000 repetitions. The session 
looks like this: 





Enter n (maximum el’t of the set) --> 1000 
Enter the number of pairs to sample —-> 10000 
0.6117 
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The program estimates pj999 0.6117 which is reasonably close to the actual value 
0.608383. If, however, we run the code for a million repetitions we get piooo © 
0.608932 which is correct to three decimal places. 

We can use the program to estimate p, for n = 10°. Running the program for 10° 
repetitions, we find p, ~ 0.607979. How good is this estimate? When we perform 
r independent repetitions of an experiment whose probability of success is p, the 
expected number of successes is rp, but the standard deviation is on the order of 4/T. 
In this case, r = 10°, so \/r = 10+. So it is reasonable to suppose that the value of 
Pn we found is correct to four decimal places. To obtain greater accuracy, we need 
either to increase the number of repetitions or (as we do in the next chapter) find a 
better method for calculating p,. 

One hundred million repetitions take a modest amount of time. It would be fea- 
sible to run for a billion repetitions, but that would only give us another “half” digit 
of accuracy. We might consider running for a trillion repetitions, but that would take 
too long. 

Here’s a reasonable rule of thumb for today’s computers. Programs that do mil- 
lions of operations using millions of bytes of memory are quick. Programs that do 
billions of operations take some time, but are feasible to run. Holding billions of 
bytes in memory, however, is at the limit of today’s personal computers. However, 
trillions of operations takes too long and most computers cannot hold trillions of 
bytes of data in memory. 





4.5 Normal random values 


Before we leave the subject of random numbers, we expand our repertoire of the 
types of random variables we can simulate. In Section 4.2 we developed code to pro- 
duce discrete and continuous uniform random variables. Here, we produce normal 
(Gaussian) random values. 

The distribution of a normal random variable is based on the classic bell curve, 
f(t) = exp(—t*). We need to modify the bell curve slightly so that the total area 
under the curve is 1, the mean of the Gaussian is 0, and the standard deviation is 1. 
To that end, we use the following for the density. 





f(t)= "ora (-2?/2) . 


From this it follows (with a bit of work) that f f(t)dt =1, [tf(t)dt =0, and 
Jt? f(t) dt = 1 (integration over all of R). 

We therefore define the Gaussian random variable X using f as its density, or 
equivalently 


O(x) = PIX <x]= [10 dt. 


62 C++ for Mathematicians 


The integrals at the end of the previous paragraph imply that X has mean zero and 
standard deviation one; for this reason, X is also known as N(0, 1)—a normal random 
variable with mean zero and standard deviation one. 

There is an efficient algorithm for producing Gaussian random values known as 
the polar or Box—Muller method. One begins by generating a point (x,y) uniformly 
at random in the unit disc. We then let 


/—21 
r=x+y’, u= = Z| = Ux, and Zn = Ly. 


Then Z; and Zp are independent N(0, 1) Gaussian random variables. Here is a C++ 
program based on this method: 
#include <cmath> 


#include "uniform.h" 
using namespace std; 


double randn() { 
double x,y,VX; 


do { 
x = unif(-1.,1.); 
y = unif(-1.,1.); 
r= X*X + Yry; 


} while (r >= 1.); 
double mu = sqrt(-2.0 * log(r) / r); 


return muxx; 


} 


The do/while loop generates points (x,y) uniformly in the square [—1,1]* until 
one that is interior to the unit disk is found. Each pass through the loop has a 2/4 
chance of succeeding, so after just a few iterations we are assured of finding a point 
chosen uniformly from the unit disk. Once the point (x,y) has been found, the rest 
of the algorithm follows the Box—Muller method. 

There is an inefficiency in this implementation. The algorithm is capable of pro- 
ducing two independent normal random values. In our implementation we find one 
of these values and simply ignore the other. We could make this procedure twice as 
fast if there were a way to preserve that second normal value for the next call to this 
procedure. To do this, we enlist the help of static variables. 

The header file randn.h looks like this: 


#ifndef RANDN_H 
#define RANDN_H 


#include "uniform.h" 
double randn(); 
fendif 


Here is the program file (randn.cc). 


CAA NDNMNAPWNK TU AA ADUN FP WN 
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Program 4.5: A program to generate Gaussian random values. 


#include "randn.h" 
#include <cmath> 
using namespace std; 


double randn() { 
static bool has_saved = false; 
static double saved; 


if (has_saved) { 
has_saved = false; 
return saved; 


} 


double x,y,Vx; 


do 4 
x S Uieulse (S15, 1.) 
7 = Uidalic (Hil gp dle) 8 
Te SSR ae NEWS 

} while (r >= 1.); 


double mu = sqrt (-2..0 « Logir) 7 2); 


saved = muxy; 
has_saved = true; 


return muxx; 





The new version includes two static variables: a Boolean value has_saved anda 
real value saved. The has_saved variable is set to false to show that the proce- 
dure does not currently hold a saved Gaussian value (in saved). See lines 6-7. 

At line 9 we check if there is a saved Gaussian value that we have not used yet. If 
so, then we change has_saved to false and return the value in saved. 

Otherwise (starting at line 14), we generate the two Gaussian values Z; and Z) 
by the polar method. We save Z2 in saved and set the flag has_saved to true. 
Finally, we return Z;. 

The statements on lines 14—21 are the time-consuming part of this procedure. By 
saving the second Gaussian value generated by the polar method, the slow part is 
only executed on every other invocation of the procedure. This makes the procedure 
nearly twice as fast. 





4.6 Exercises 


4.1 Suppose two points are chosen uniformly at random within the unit square 
(0, 1]?. Write a program to estimate the expected (average) length of the seg- 
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4.2 


4.3 
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ment joining such points. 


Buffon’s Needle. Imagine a needle is dropped at random onto a floor painted 
with equally spaced parallel lines. The length of the needle is the same as the 
distance between the lines. 


Write a program that simulates dropping the needle and that counts the number 
of times the needle crosses one of the lines drawn on the floor. 


If you wish to use standard trigonometry functions, such as cos, or the floor 
function, insert a #include <cmath> directive at the start of your program. 
See Appendix C.6.1. 


Sylvester’s Four-Point Problem. Let K be acompact convex subset of the plane 
with nonempty interior. Let P(K) denote the probability that when four points 
are chosen independently and uniformly in K, then they lie at the vertices of a 
convex quadrilateral (as in the left portion of the illustration but not the right). 


Write procedures to (a) generate a point uniformly at random inside a circle, 
(b) generate a point uniformly at random inside a triangle, and (c) test whether 
four points determine the vertices of a convex quadrilateral. 


Use your procedures to estimate P(K) for the cases where K is a circle or a 
triangle. 


Random point on a circle. Suppose you wish to generate a point uniformly 
at random on the unit circle, {(x,y) : x7 +y* = 1}. Suppose the procedure is 
declared like this: 


void point_on_circle(double& x, doubleé y); 


Here are two ways you might implement this procedure. 

First, you can generate a uniform [0, 1] value that you multiply by 27; call the 
result 0. Then set x and y to be cos 9 and sin@. 

Alternatively, you can generate a point in the interior of the unit ball by the 
rejection method. [That is, pick points (x,y) € [0,1]? until you find one that 
satisfies x? + y? < 1.] Then rescale by dividing by \/x?+ y?. 

Which do you think is faster? Create two versions of the procedure and time 
how long it takes each to generate 100 million points. 


4.5 


4.6 


4.7 


Random Numbers 65 


Random point on a sphere. Continuing Exercise 4.4, we consider the issue of 
generating a point at random on the surface of a sphere in R? and in higher 
dimensions. 


One way to generate a point on the unit sphere in R° is to generate x,y,z 
uniformly in [—1,1]. If x? +-y? +z? < 1, then we scale by 1/,/x2+y?+2 to 
generate the point. Otherwise, we generate another triple and try again. 


What is the probability of successfully generating a point during a given itera- 
tion? 


Next, explain why this procedure is woefully inefficient in high-dimensional 
space. Try to create an alternative method. 


Create a procedure int random_walk(); that simulates a random walk on 
the integers. That is, random_walk () returns the position of a particle whose 
initial position is 0. Each time random_walk () is called, the particle moves 
one step left or right, each with probability 50%. The return value is the new 
position of the particle. 


For example, calling random_walk 20 times might produce the following 
values. 





101234545 43434343232 } 





Write a pair of procedures int up() and int down() that behave as fol- 
lows. When up () is called, a certain value is increased by 1 and the new value 
is returned. Similarly, when down () is invoked, the value is decreased by | 
and that new value is returned. At the start of the program, the value is zero. 


For example, suppose we run the following code. 


cout << up() 

cout << up() << " "; 
cout << up() 

cout << down() << " "; 
cout: << up() << "7; 
cout << down() << endl; 


Then the following output is produced. 





le 232-3 2 } 





Chapter 5 
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In Chapter 3 we introduced the following problem. Let p, be the probability that 
two integers, chosen uniformly and independently from {1,2,...,n}, are relatively 
prime. What can we say about p, as n — co? We computed p,, for various values of 
n by direct enumeration. As n approached 10°, the program became slow and so we 
sought another approach. 

In Chapter 4 we tried a Monte Carlo approach. Although our program enables us 
to estimate p, for n equal to one million (or larger), to get decent accuracy we need 
to run the program for too many iterations. 

In this chapter we take another approach using Euler’s totient. 





5.1 Euler’s totient 


Euler’s totient is a function @ defined on the positive integers. For n € Z*, we 
define @(n) to be the number of elements of {1,2,...,7} that are relatively prime to 
n. For example, 9(10) = 4 because the only integers between | and 10 (inclusive) 
that are relatively prime to 10 are 1, 3, 7, and 9. 

Euler’s totient has immediate relevance to our problem. We want to count the 
number of pairs (a,b) with 1 < a,b <n and gced(a,b) = 1. Alternatively, we can 
count the number of such pairs with a < b. Of course, we miss the pairs with a > b, 
so we would just double the result and subtract one (for double-counting the pair 
(1,1)). Symbolically, we have 





n 
Pn = = -14+2¥ et) 
k=1 
We can calculate @(k) by considering all the integers from | to k and check which 
are relatively prime to k. This, however, would lead to an algorithm that is no differ- 
ent from the one in Chapter 3. 
Fortunately, there are more efficient ways to calculate 9. 


We begin our analysis of Euler’s totient with a few special cases. 
If p is a prime, then all but one member of the set {1,2,...,p} are relatively prime 
to p. Therefore O(p) = p—1. 
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Next consider @(p7) for a prime p. In the set {1,2,...,p*} the only numbers 
that are not relatively prime to p* are the multiples of p, and there are p of those. 
Therefore p(p*) = p* — p= p(p—1). 

More generally, consider @(p”) where p is prime andn € Z*. In {1,2,...,p”} 
only the multiples of p are not relatively prime to p”, and there are p”~! of those. 
This gives the following. 


Proposition 5.1. Let p be a prime and let n be a positive integer. Then @(p") = 
p"—p"* =p" \(p—1). 














Now that we have examined for powers of primes, let us examine the special 
case ~(77). Note that for 1 <n <77, we have 


ged(n,77) =1 <= > — ged(n,7)=1 and ged(n,11)=1. 
By Proposition 3.1, 
gced(n,7) = ged(7,n mod 7) and gcd(n, 11) = ged(11,n mod 11). 
Let ny =n mod 7 and nz =n mod 11. If 7x is relatively prime to 77 and 
x=n, (mod 7) and x=n (mod 11) 


then x is also relatively prime to 77. Furthermore, there is a unique such x in 
{1,2,...,77}; this is a consequence of the Chinese Remainder Theorem. 


Theorem 5.2 (Chinese Remainder). Let a and b be relatively prime positive integers, 
and let c,d € Z. Then the system of congruences 


x=cmoda 
x=dmodb 











has a unique solution in {1,2,...,ab}. 





So, every x € {1,2,...,77} that is relatively prime to 77 satisfies a pair of congru- 
ences of the form 


x=n, (mod 7) and x=n. (mod 11) 


where n, is relatively prime to 7 and nz is relatively prime to 11. Conversely, for 
every pair (m1,n2) with (a) 1 <n, <7, (b) 1 <m < 11, (c) ged(m,7) = 1, and 
(d) gcd(nz,11) = 1, there is a unique x between | and 77 that satisfies the above 
congruences and is relatively prime to 77. 

Therefore (77) equals the number of choices for (n;,2), and that is precisely 
(7) x o(11) = 6x 10 = 60. 
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A careful reading of the analysis of @(77) reveals that the only facts we used about 
7 and 11 is that they are relatively prime. Thus the argument can be rewritten to give 
a proof of the following. 











Proposition 5.3. If a and b are relatively prime, then (ab) = 9(a)Q(b). 





From these propositions we derive the following formula for p(n). 


Theorem 5.4. Let n be a positive integer and let p\,p2,..., pr be the distinct prime 


divisors of n. Then 
o(n) =n(1-4) (1-4)--(1-4), 
P\ P2 Pr 


Proof. We factor n into primes as 
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er 
N=P, Px -""Pt 


where the p; are distinct primes and the e; are positive integers. By Propositions 5.3 
and 5.1 we have 


(1) = 9(P1') (PH) ++ P(Pr') 
=| =] ro 
= (o{ \(p1—1)) (0 '(p2-1)) > (=) 
1 1 1 
“ape gon (es) 
Pl P2 Pt 
1 1 1 
(A) (-B-3) 
Pl P2 Pt 
Thus, if we know the prime factors of n, we can calculate @(n). This results steers 
the discussion for the rest of this chapter. We begin by developing algorithms to 


factor long integers. We create a factor procedure that produces the full prime 
factorization of an integer; we use an array to hold the result. 

















5.2. Array fundamentals 


The first goal of this chapter is to create a procedure that takes an integer and gives 
us a list of the prime factors of that integer. For example, if the integer is 120, then 
the list of prime factors is (2,2,2,3,5). 

There are several ways to hold lists in C++. The most primitive method is to use 
an array. An array is simply a list of values of a given type. To declare an array of, 
say, long integers, we use a statement such as this: 


int vals[10]; 
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This declares val to be an array of ten! integers. The elements of the array are 
indexed starting from zero. That is, the ten elements of vai are these: 


val[0O] val[1] val[2] val[3] val[4] 
val[5] val[6] val[7] val[8] val[9] 


Each of these behaves exactly as does a long variable. One can have statements such 
as val [3]=2*val[0]+val[5]; or++val[7];. Elements of an array are accessed 
using square brackets, not parentheses. If an array is declared to have n elements, 
the first is always indexed by subscript 0 and the last by subscript n — 1. Element n 
of such an array is not defined. 

To print out all the members of an array, one can use a for loop: 
for (int k=0; k<10; k++) { 

cout << val[k] << endl; 


} 


However, the following does not work: cout << val << endi;. This does not 
print the values of the val array, even though it is legal C++. Furthermore, arithmetic 
operations on elements of an array must be specified element by element. If you 
wish to increase every element of an array by one, you need a statement such as this: 
for(int k=0; k<10; k++) val[k]++;. Unfortunately, the statement val++; 
is not illegal, but it does not do what you might want or expect. If alpha and beta 
are two arrays, the expression alpha==beta does not determine if corresponding 
elements in the arrays are equal, but the compiler might not complain because it is a 
legal C++ expression. 

Worse yet, if val is an array of ten elements, then only val[0] through val [9] 
are legitimate array elements. Surprisingly, using val [10] or val [17] is not pre- 
vented, but severe problems may result from accessing elements beyond the normal 
bounds of an array. 

The C++ array is the most computationally efficient mechanism for storing a list, 
but it is not the only manner. We explore several alternatives in Chapter 8. 

It is helpful to have a basic understanding the underlying mechanism by which 
arrays work. To do that, we need to mention the concept of a pointer. In this book 
we scrupulously avoid dealing with pointers; they are confusing and easily lead to 
subtle programming errors. However, we do need to be at least vaguely aware that 
C++ uses pointers. What is a pointer? A pointer is a variable whose value is a 
location in the computer’s memory. Each byte of a computer’s memory is numbered, 
and a pointer holds such a number. In the case of arrays, the name of the array is 
actually a pointer to the location of the first element of the array (e.g., the memory 
location that holds val [0]). So a statement of the form val++; changes the pointer 
val so that it now points to a different location in memory. (In fact, it would now 
point to the location of val [1] but this is more than we want or need to know right 
now.) A statement of the form cout << val << endl; prints out the location 


Of course, we can declare an array to hold hundreds or thousands of elements. However, some compilers 
place a limit on the maximum size of an array. There is a simple way to exceed that limit and this is 
explained in the footnote accompanying Program 5.8 on page 82. 
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number where the first element (with subscript zero) of val is housed. Try it! You 
should get a result that looks something like this: 0xbffffa20. The leading 0x is 
C++’s way of indicating that the number that follows is in base-16. The remainder is 
the number in standard base-16 (where a is a digit equal to ten, b is a digit equal to 
eleven, and so on). 

When you declare an array with a statement such as int val[10]; the computer 
sets aside a block of memory to hold ten ints. When you refer to, say, val [3], the 
computer figures out where in memory this quantity sits by adding 3xsizeof (int) 
to the base address val. 

You may be thinking: Why do I need to know all this stuff?!? Mostly, you do not 
need to worry about this. The important things you need to know are these. 


e Array elements are indexed starting from 0. 


e Operations cannot be performed on arrays as a whole; you need to operate on 
the elements of arrays individually. 


e The name of the array is a valid C++ entity. Once declared, the only informa- 
tion that the name of the array carries is the location in memory of the start of 
the array and the type of elements held in the array. 


The third point is important when we write procedures that have array arguments. 
In the next section we develop a procedure called factor that takes two arguments. 
The first is the integer we want to factor. The second is an array to hold the prime 
factors. 





5.3. A procedure to factor integers 


In this section we develop a procedure to factor integers. The input to the pro- 
cedure is a long integer, n. The procedure gives us two results: an array holding 
the prime factors and an integer telling us how many prime factors (multiplicities 
counted) we found. For example, if the number to be factored is 20, the procedure 
finds that the factors are (2,2,5) and that there are three prime factors. 

We use C++’s return statement to report on the number of factors found. How- 
ever, the return mechanism does not work for arrays. Instead, we give the proce- 
dure an array in the argument list. 

The declaration of the factor procedure is this: 


long factor(long n, longs flist); 


The first argument, n, is the number we want to factor. The second argument, flist, 
is an array to hold the answer (the factors of n). The type of flist is long». The 
star indicates that flist is an array. (Technically, the star signifies that flist isa 
pointer.) The long to the left of the word factor signifies that factor returns a 
long integer—the number of prime factors found. 
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The technicality that flist is a pointer is relevant to us only in this regard. Al- 
though C++ uses call by value as its standard way to pass arguments to procedures, 
the array flist is not copied to the factor procedure. Instead, the location (i.e., 
pointer) of the array is sent. Therefore the fact or procedure is capable of modifying 
the elements of £1ist in the procedure that called flist. 

The factor procedure has no mechanism to ensure that the array f1ist contains 
enough elements to hold the primes found. It is the responsibility of the user to be 
sure that the array is large enough to hold the answers. If the size of your computer’s 
long integers is 4 bytes, then these integers are less than 2°*. Therefore, no long 
can have more than 32 factors. Perhaps you have a computer in which long integers 
are 64 bits; in that case, if £1ist has at least 64 elements, no problem can arise. This 
means the procedure that calls factor should look something like this: 


long prime_factors[200]; 
long nfactors; 


nfactors = factor(60, prime_factors); 


After this code runs nfactors holds 4 and the array prime_factors holds the 
values 2, 2, 3, and 5 in positions 0 through 3, respectively. Positions 4 through 199 
are unaffected by this call to factor. 


It is time to design the factoring algorithm. We begin by handling exceptional 
cases. What if the user sends a negative number or zero to be factored? For negative 
values, we can simply replace the argument by its absolute value. Asking to factor 
zero is asking for trouble. Returning a value of 0 is not quite right, because that is 
what we would return when we are asked to factor 1. Returning a positive value is 
also misleading. We settle for the unhappy choice of returning the value —1 in case 
the user requests a prime factorization of 0. 

If we are asked to factor 1, we simply report there are no prime factors (i.e., 
return 0;). 

So we suppose that n > 2. The method we use to factor n is this. We check if 
n is divisible by 2. If so, we record 2 in the first element (index zero) of flist 
and replace n by n/2. We keep track of where we last wrote into the flist array 
with a variable we name idx. Initially idx equals zero. Once we record a prime 
in flist [idx] we then increase idx by 1. We keep doing this until 1 is no longer 
divisible by 2. 

At that point, we check n for divisibility by 3. We continue dividing until no 
factors of 3 remain. With each factor of 3 that we find, we record a3 in flist [idx], 
advance idx by one, and replace n by n/3. 

It would be logical to next try divisibility by 5, but C++ does not “know” that 5 is 
the next prime. Instead, we try divisibility by 4 which, of course, fails because we 
have already divided out all of n’s factors of 2. 

We continue in this manner, trying a divisor until it is exhausted and then advanc- 
ing to the next divisor. When do we stop? Once we have divided out all of n’s prime 
factors, it equals 1; that’s when we stop. 

The algorithm is depicted in the flowchart in Figure 5.1. 
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Make sure that n is a positive integer. 
Set idx=0. (Index into the flist array.) 
Set d=2. (Current divisor.) 


Program is finished. 
Return value of idx 
(number of divisors). 





Does d Save d in flist[idx] 
divide and increase idx by l. 
n? Replace n by n/d. 





Increase d by l. 





Figure 5.1: A flowchart for the factoring algorithm. 





We are now ready to implement this procedure in C++. To begin, we write the 
header file, factor.h. 





Program 5.1: Header file factor .h for the first version of the factor procedure. 


#ifndef FACTOR_H 
#define FACTOR_H 


Factor an integer n. The prime factors are saved in the second 
argument, flist. It is the user’s responsibility to be sure that 
flist is large enough to hold all the primes. If n is negative, we 
factor -n instead. If n is zero, we return -1. The case n equal to 
1 causes this procedure to return 0 and no primes are saved in 
us UA. 


2 ie i OM, OS ORR oS 
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* 
* @param n the integer we wish to factor 
* @param flist an array to hold the prime factors 
* @return the number of prime factors 
x/ 
tong bacecriiongrn, longs fist iy 


#endif 





Next is the C++ source code. 





Program 5.2: Source file factor. cc for the first version of the fact or procedure. 


#include “factor.h" 
Herons; ialele@re (Loi; io, Ileveye/ss se lakeic)) 


ff Ais is 26re, we return =1 
if (n==0) return -1; 


// Tf n is negative, we change it to |n| 
aie ((jat<(0))) eh = ial 


// Tf n is one, we simply return 0 
if (n==1) return 0; 


// At this point we know n>1 


int Tdk = 0; // index into the flist array 
al sieters ON ey // current divisor 


while (n>1) { 
while (nd == 0) { 
flist[idx] = d; 
arapiLebes 
n /= d; 
} 
ararely 
} 


return idx; 





Lines 5—12 deal with the exceptional cases. 

Line 16 sets up the variable idx. Throughout the procedure idx contains the index 
of the next location in the flist array where we record the prime factors. We set 
idx equal to zero so the first prime we record goes into the first element of flist. 

Line 17 sets up the variable a. This is the current divisor we are testing. 

The heart of the procedure lies in lines 19-26. We keep trying to find factors of n 
as long as there are factors to be found (i.e., as long as n holds a value greater than 
1). On line 20 we test n for divisibility by da. If successful, we record d in the array 
flist at location idx, increase idx by one so it refers to the next available cell in 
flist, and divide out the factor of d from n. We keep doing this until n is no longer 
divisible by d. At that point, we increase a by one and continue. 





CAIN NDUNAWNK TCU AANAADUN FP WN eK 


Arrays 75 


At the end, idx has been increased once for every prime factor we found. So we 
simply return its value at line 27. 


Here is a main to test the factor procedure. This program prints out the prime 
factorization of all integers from 1 to 100. 





Program 5.3: A main to test the factor procedure. 


#include “factor.h" 
#include <iostream> 
using namespace std; 


/[*x* 

x A program to test the factor procedure. 
*/ 

de Ma f 


kong EhLvst [LOO ye // place to hold the factors 


fer (long nale n<=1007 nts) 1 


HINGE WEACCORS = ievelcoie (in, il Sic)} p 
sowie << in <K “Vee 
oie [(aliste KkaOs Ikenitaciorse Iki) our << wiligieik]) << V We 


cout << endl; 





On line 11 we declare f1ist to hold 100 long integers. The for loop on lines 
13-18 requests that we factor n for all values from 1 to 100. The call to factor is 
on line 14. We save the number of factors found in a variable named nfactors and 
the factors themselves populate the elements of the array flist. 

Line 15 prints the current value of n and then a tab character. The sequence \t 
stands for a tab; this way the list of factors ends up nicely arranged. 

Line 16 prints out the factors of n separated by spaces and then line 17 starts a 
new line on the screen. 

The output looks like this. 








1 

2 2 

3 3 

4 22 

5 5 

6 2 3 

7 7 

8 222 

9 2 3 

10 25 

11 alk 

(many lines deleted) 

ieee) 


Ve ay ae ay Bie 


OOO 
Yan WwW 
Ne) 
a 
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98 2 7 
29 3. 3 
100 2 2 








5.4 A procedure to calculate Euler’s totient 


With the factor procedure built, our next step is to build a procedure to calculate 
Euler’s totient. The totient procedure takes a long argument (n) and returns a 
long result (@(n)). Here is the header file totient .h. 





Program 5.4: Header file for the tot ient procedure. 


#ifndef TOTIENT_H 
#define TOTIENT_H 


[xx 
* Euler’s totient function. 
* @param n the number whose totient we seek 


* @return the number of elements in {1,2,...,n} that are relatively 
* prime to n. 
x/ 


long totient (long n); 


#fendif 





We use Theorem 5.4 to design the totient procedure. For example, let n = 
36,750. Factoring n gives 36,750 =2x3x5x5x7x7. Then 


O(n) = (2-1) x (3-1) x5x5x (5-1) x7 x (7-1) = 8400. 


If the prime p appears e times in the factorization of n, then in @(n) it contributes 
peep): 

The procedure to calculate @(n) begins by factoring n and saving the result in an 
array, flist. We then step through flist one element at a time. If flist[k] 
equals flist[k+1], then we multiply by flist[k]; otherwise, we multiply by 
flist[k]-1. To do this, we use an expanded version of the if statement. The 
expanded version is called an if-else statement and is structured like this: 
if (condition) { 


statements1l; 
} 
else { 
statements2; 


} 


When this structure is encountered, the condition is evaluated. If it evaluates to 
TRUE then statements! are executed and statement s2 are skipped. However, if 
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condition evaluates to FALSE, then statements1 are skipped and statement s2 
are executed. 

We need to be careful when we reach the end of the array; we do not want to 
access the element past the end of the array. 

Here is the code. 





Program 5.5: The code for the tot ient procedure. 


#include "totient.h" 
#include "factor.h" 


long totient(long n) { 
// nandle special cases 
abie (jar <= @)) eeieisncia Op 
if (n == 1) return 1; 


1 mac orem 
doing; Ae ha Sie" || L000) || 5 
Long niaclorae = factor(n,flise) > 


long ans = 1; 
oie (hoe; SHO ecoitercicorsp leary) 4 


aac (ke << taliteyeiciosesj—il)) ff 
te (Geibsvese [ie ]] == seilakene [arity 1 
ans *= flist[k]; 
} 
else { 
ans *= flist[k]-1; 
} 
} 
else { 
ans *= flist[k]-1; 
} 





} 


return ans; 


} 





After factoring n, we set up a variable named ans that holds the result to be re- 
turned (line 13). 

Lines 15-28 form the core of the procedure. This is a for loop that steps through 
the array f1ist. If we are not yet at the last element of the array (checked on line 17) 
we compare the current element of the array and the next element of the array for 
equality. If they are equal, we multiply ans by flist[k] (line 19) but otherwise 
(see the else on line 21) we multiply by flist [k]-1 (line 22). 

If we are at the last element of the array (the else on line 25), then the proper 
factor is flist[k]-1. 

We test the tot ient procedure with this simple main: 

#include "totient.h" 


#include <iostream> 
using namespace std; 
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/[*x* 

* A program to test the totient procedure. 
*/ 

int main() { 


for (int k=1; k<=100; k++) { 
cout << k << "\t" << totient(k) << endl; 
} 


return 0; 


The resulting output looks like this: 








il 1 
2 a 
3 2 
4 2 
S} 4 
6 2 
7 6 
8 4 
9 6 
10 4 
11 10 
(many lines omitted) 
90 24 
91 72 
92 44 
93 60 
94 46 
95 ¥2 
96 32 
97 96 
98 42 
99 60 
100 40 





5.5 The Sieve of Eratosthenes: new and delete [] 


The totient procedure we developed in the previous section works well, but 
relies on an inefficient factoring procedure. Because we expect to be calculating 
0(k) for millions of different values of k, it is worth the effort to make the procedure 
as efficient as possible. 

One of the inefficiencies in the factor procedure arises from the lack of a table 
of prime numbers. If we had a table of prime numbers we could avoid wasted steps. 
If we only needed to factor one number or only wanted one value of @, it might not 
be worth the effort. However, because we plan to compute @ millions of times, we 
can greatly increase the speed of our program by first building a table of primes. 
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An efficient method to build a table of primes is known as the Sieve of Eratos- 
thenes. To find all the primes up to some value N, we write down all the integers 
from 2 up to N (we skip 1). We circle 2 (it’s prime) and then cross off all other 
multiples of 2. The first unmarked number is 3. We circle 3 then cross off all other 
multiples of 3. Notice that 4 is crossed off, so the next unmarked number is 5. We 
circle 5, and then cross off all other multiples of 5. We continue in this manner until 
we reach N. At the end, the circled numbers are exactly the primes; every other entry 
in the table has been crossed off. The algorithm is illustrated in Figure 5.2. 
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Figure 5.2: Illustrating the Sieve of Eratosthenes algorithm. 
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We now create the sieve procedure. In a header file, sieve.h we declare the 
procedure as follows. 





Program 5.6: The header file for a procedure to build a table of primes via the Sieve 
of Eratosthenes. 


#ifndef SIEVE_H 
#define SIEVE_H 


[xx 


The Sieve of Eratosthenes: Generate a table of primes. 


@param n upper limit on the primes (i.e., we find all primes 
less than or equal to n). 

@param primes array to hold the table of primes. 

@return the number of primes we found. 

if 


* 
* 
* 
* 
* 
* 
* 
* 


long sieve(long n, long* primes) ; 


fendif 





The parameter n is an upper bound on the primes we seek. The array primes 
is a place to hold the primes found by the procedure. It is the responsibility of the 
procedure that calls sieve to make sure that primes is big enough to hold the array. 
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For example, if we wish to generate all primes up to ten million (10’), how big 
does primes need to be? The prime number theorem gives us an estimate. The 
number of primes less than or equal to n is approximately n/logn. In the case n = 
10’, this gives an estimated 620,421 primes. In fact, the number is a bit higher: 
664,579 to be exact. To be safe, the calling procedure should make sure that primes 
is (say) 1.5 times the estimate in the prime number theorem. 

The code for the sieve procedure introduces a new idea. The procedure requires 
an array to hold the sieve. If n is 10’, then this table requires 107 entries. For 
efficiency’s sake, we want the individual entries in the table to use as few bytes as 
possible. We could declare this table to be made up of short integers, but the char 
type is only one byte on most systems. Let’s call the table theSieve. We may be 
tempted to begin our program as follows. 


long sieve(long n, long* primes) { 
char theSieve[n]; // array for the sieve 


Unfortunately, this is illegal. In declaring an array, the size of the array must be a 
constant; it may not be a number that can’t be known until the program is run. 

We could declare theSieve to be a huge array (say, of size ten million). However, 
if we wish to use this procedure for larger values of n we would need to rewrite the 
program. 

A better solution is to create an array using C++’s new operator. This operator 
allows us to create an array whose size is determined when the program is running. 

The beginning of the sieve procedure looks like this: 


long sieve(long n, long* primes) { 
if (n<2) return 0; // no primes unless n is at least 2. 


charx theSieve; 
theSieve = new char[n+1]; // hold the marks 


The initial i £ statement handles the case when a user might call sieve with, say, n 
negative. The next two lines are the interesting part. 

The line charx theSieve; declares theSieve to be a name that can refer to 
an array of chars. However, this name may not be used yet because the array is 
not created. The star on the type name char is important; without it, the name 
theSieve would refer to a single character, not an array. 

At this point we have a name to use for the array, but no space in memory to hold 
the array. The next line allocates the space. The statement 


theSieve = new char[nt+l]; 


does two things. First, it requests a block of n+ 1 pieces of memory, each big enough 
to hold a char. Second, it causes theSieve to refer to the start of that block of 
memory. In the program, we want to use the entries up to theSieve [n]; this is why 
we requested n+ | array elements. 

There is an important difference between an array that is declared with the usual 
sort of statement (such as long primes[10];) and an array that is created with new 
(such as longx primes = new long[10];). Arrays created with the standard 
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declaration automatically disappear when the procedure in which they are defined 
exits; at that point, the memory they use is automatically freed to be used by other 
parts of the program. However, an array allocated using the new statement remains 
reserved until it is explicitly released. 

A block of memory allocated by the use of new must later be released with a 
delete[] statement like this: 


delete[] theSieve; 


There must be one and only one delete[] balancing each use of new. If the 
delete [] is missing, the array persists until the program exits. If one has repeated 
requests to new (without matching delete[]s), then more and more memory is 
tied up in arrays until the computer runs out of memory to honor the requests. This 
situation is known as a memory leak. 

On the other hand, if one tries to perform a delete[] on the same block of 
memory more than once, the gates of the underworld will open and demons will rule 
the earth. Or your program might crash. 

The sieve program follows. 





Program 5.7: The sieve procedure. 


#include "sieve.h" 
long sieve(long n, long* primes) { 
af (n<2) return 0; // no primes unless.n 26 at least 2. 
char*« theSieve; 
theSieve = new char[nt1]; // hold the marks 
// Names of marks to put in theSieve 
const char blank = 0; 


const char marked = 1; 


// Make sure theSieve is blank to begin 
for (long k=2; k<=n; k++) theSieve[k] = blank; 


long idx = 0; // index into the primes array 


for (long k=2; k<=n; k++) { 





if (theSieve[k]==blank) { // we found an unmarked entry 
theSieve[k] = marked; // mark it as a prime 
primes[idx] = k; // vecord k in the primes array 
ieleanar pe 


// Now mark off all multiples of k 
for(long d=2*k; d<=n; dt=k) theSieve[d] = marked; 


} 
delete[] theSieve; 
return idx; 
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Line 9 allocates the array theSieve. The matching delete [] is on line 30. 

On lines 12 and 13 we create names for the marks we use in the array theSieve. 
We use two types of mark to distinguish the two types of cells: blank cells and 
marked cells. We could have simply used the values 0 and | in the program, but 
unnamed constants are to be shunned. By giving these names we make the code 
more understandable. The const qualifier in the declaration tells the compiler that 
these values, blank and marked, never change. This does two good things. It 
prevents us from accidentally writing code that would change these symbols and it 
enables the compiler to produce more efficient object code. 

Line 16 ensures that the array theSieve is entirely populated with blank (ie., 
zero) before we begin. In a perfect world arrays are given to you filled with sensible 
default values (such as zero). However, it is folly to rely on this. An initial run 
through the array to make sure it is in the state we hope is quick and easy. 

The variable idx on line 18 is an index into the array primes. It refers to the 
next available cell in primes at all points in the program. At the end, it will have 
been incremented once for every prime we record, and so it will hold the number of 
primes found. That is why we use idx as the return value on line 31. 

The sieving takes place on lines 20-29. When we come to an entry k in theSieve 
that is blank it must be a prime. We mark that location, record the number k in 
primes (and increment idx). Then (line 27) we place a mark in every cell that is a 
multiple of k. 


Here is a main to test the sieve procedure.” 





Program 5.8: A program to test the sieve procedure. 


#include "sieve.h" 
#include <iostream> 
using namespace std; 


const long N = 10000000; // ten million 
const long TABLE_SIZE = 800000; // prime number theorem overestimate 


[xx 

x A program to test the sieve procedure. 
*/ 

RB gieariice hen @ amt 


long primes [TABLE_SIZE]; 
long np = sieve(N,primes) ; 


cout << "We found: * << mp << " primes” <<-endl; 

cout << "The first 10 primes we found are these: " << endl; 
2Note: On Windows computers this program might crash because of line 13. Some computers place a 
limit on the maximum size array one can declare. The solution is to allocate large arrays dynamically. That 


is, replace line 13 with this: long* primes; primes = new long[TABLE_SIZE] ; Remember 
to delete[] primes; before the end of the program. 
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cout << endl; 


cout << "The largest prime we found is " << primes[np-1] << endl; 


return 0; 





Finding all the primes up to ten million is quick. The output from the program 
appeared on my screen in under four seconds. 





We found 664579 primes 

The first 10 primes we found are these: 
2S 907 LE eee be 2a 28 

The largest prime we found is 9999991 








5.6 A faster totient 


With a table of primes at our disposal, we can calculate p(n) without first factoring 
n; here’s how. For each prime p in the table, we check if p divides n. If so, we replace 
n by (n/p)(p — 1). In the end, we have calculated 


( ) ( ) i ( ) 
P\ P2 Pt 
which, by Theorem 5.4, iS o(n). 


The procedure we create has two arguments. The declaration of this function (in 
the file tot ient .h) looks like this: 





long totient (long n, const long* primes); 


Ignore the const keyword for a moment. 

The first argument is n: the number for which we wish to calculate @. 

The second argument is a table of primes. The type of this argument is long« 
which indicates that primes holds the starting position of an array of long integers. 
The table of primes is not duplicated; what we pass to the totient procedure is the 
address of the table. 

The procedure returns a long: the totient of n. 

Now we consider the extra word const in the declaration. When we pass an 
array to a procedure it is possible for the procedure to change the values held in the 
array. Indeed, we relied on that fact when we created the sieve procedure. Recall 
that sieve is declared as long sieve(long n, long* primes);. The sieve 
procedure receives the array address primes and can then populate that array with 
the desired values. 
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In the case of our new totient procedure, we use the values housed in the array 
primes, but we do not alter them. The const qualifier asserts that the procedure 
totient does not modify any element in the array primes. 

Although the procedure totient would work equally well without the const 
qualifier, it is a good habit to declare arguments as const when appropriate. If (by 
mistake) the code in your procedure is capable of changing elements in the array, the 
compiler will complain and help you spot the error. 


The code for the new totient procedure is this: 





Program 5.9: A faster tot ient procedure that employs a table of primes. 


#include "totient.h" 


long totient(long n, const long* primes) { 
if (n<=0) return 0; 


long ans = n; 
for (long k=0; primes[k] <= n; k++) { 
if (n%primes[k]==0) { 


ans /= primes[k]; 
ans *= primes[k]-1; 
} 
} 
return ans; 


} 





The program is fairly straightforward. We make a copy of n in a variable named 
ans. (This isn’t necessary, but improves clarity.) In lines 7-12 we consider all primes 
that are less than or equal to n. If such a prime p is a factor of n, we modify ans 
by dividing out p and then multiplying by p — | (lines 9-10). In the end, ans holds 
p(n). 

The only caveat is that we must be sure that the array primes contains all the 
prime factors of n. One way to do this is to generate all primes up to n using sieve. 
For example, the following main tests the faster tot ient procedure. 

#include "totient.h" 
#include "sieve.h" 


#include <iostream> 
using namespace std; 


[xx 

* A main to test the faster version of Euler’s totient on 
* the integers from 1 to 100. 

x/ 


int main() { 
const int N = 100; // testing up to N 


long primes[10*N]; // table of primes 
sieve (10*N, primes); 
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for (long k=1; k<=N; k++) { 
cout << k << "\t" << totient(k,primes) << endl; 
} 
} 


The output is a two-column table. The first column contains the integers from | to 
100, and the second column contains Euler’s totient of these. 


5.7 Computing p, for large n 


Recall from the beginning of this chapter that we can calculate p, by the following 
formula, 


n 
Pn => |-142F oW) 
i k=1 
In this section we write a program to calculate p, for n equal to one million. 

The main part of the program adds @(k) as k goes from | to one million. Because 
we know pp is around 0.6, we expect the final sum to be around 0.6 x 10!* which is 
larger than a long on a system where sizeof (long) is 4 bytes. (A 32-bit integer 
can store values up to about two billion, but not in the trillions.) So we need to use 
along long (or __int64); fortunately on my computer this is an 8-byte quantity 
and can hold values that are nearly 10!°. This is more than adequate to the task. 

Calculating this sum takes many minutes (but not many hours). We can request 
the program to report its progress along the way. In the program we present, we 
report p; whenever k is a multiple of 10°. Here is the program. 





Program 5.10: A program to calculate p, for n equal to one million. 


#include "totient.h" 
#include "sieve.h" 
#include <iostream> 
#include <iomanip> 
using namespace std; 


[xx 
x A program to calculate the probability that two integers chosen in 
x {1,2,...,n} are relatively prime. This probability is calculated 
* for values of n up to ten million. 
x/ 
pkigte: iain ()) af 
const long N = 1000000; I? One mv lion 


const long TABLE_SIZE = 200000; // prime number th’m overestimate 


// set up the table of primes 


19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32, 
33 
34 
35 
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long* primes; 

primes = new long[TABLE_SIZE]; 
long np; 

np = sieve(2*N,primes) ; 


long long count=0; Hi Sioval ne Golesi (Gl) ueveieim Al jee@) iol 


cout << setprecision(20); 
for (long k=1; k<=N; k++) { 
count += totient(k, primes) ; 
if (k%100000==0) { 
Coun es kf OOOM a Eee es 
cout << double(2*count-1) / (double(k) x*double(k)) << endl; 
} 
} 


return 0; 





Notice there is a new header included at line 4. The iomanip header provides 
devices to change the output style. In our case, we want to print out more digits 
of p, than usual. This occurs on line 26. The cout << setprecision(20); 
statement modifies cout so that it prints up to 20 decimal digits for double real 
numbers (trailing zeros, if any, are not printed). The iomanip header is needed to 
define setprecision. (See Section 14.6 for more information on adjusting output 
format.) 


Lines 19-22 are used to generate the table of primes. 


The variable count, declared on line 24, is used to accumulate the sum of @(k). 
As discussed, this needs to be type long long because the final sum exceeds the 
maximum value a long can hold. 


The core of the program is on lines 27-33. This is a for loop that increments 
count by @(k) as k goes from one to one million. On line 29 we check if k is 
divisible by 100 thousand; if so, we report p, at that time. 


Here is the output of the program (which took about 25 minutes to run on my 
computer). 





cr 











100 thousand 0.6079301507 

200 thousand 0.60792994587500004 
300 thousand 0.60792774407777783 
400 thousand 0.60792759136874996 
500 thousand 0.607928317404 

600 thousand 0.6079276484527778 
700 thousand 0.60792730424285712 
800 thousand 0.60792796007343752 
900 thousand 0.6079273649074074 
1000 thousand 0.60792710478300005 
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5.8 The answer 


It certainly appears that p, is converging and that the limit, to six decimal places, 
is 0.607927. The next step, necessarily, takes us beyond C++; we need to recognize 
this number to formulate (and prove!) a conjecture. 

Fortunately, there are good tools for this step. Neil Sloane’s On-Line Encyclo- 
pedia of Integer Sequences is a remarkable resource that takes us directly to the 
answer. Visit http: //www.research.att.com/~njas/sequences/ and enter 
the sequence of digits into the sequence search engine: 6 0 7 9 2 7 and press the 
SEARCH button. After a brief delay, the answer emerges: 


1 6 
say = = = 0.6079271018540... 
(2) m 
is the number we seek. (The site also gives several references to this well-known 
problem.) 
We close this chapter with a sketch of the proof. 


Sweeping all worries about convergence under the rug, consider two large integers. 
What is the probability they are not both even (a necessary condition for the numbers 
to be relatively prime)? Each has a 5 chance of being even, so the probability neither 
has a factor of 2 is (1 - i): More generally, the probability neither has a prime p as 
a common factor is (1 - ip"). So the limit of py is 


1 
IT (1 =) 
Pp P 
where the product is over all primes. 
Recall that €(2) is given by 


(Q=L5. 


This can be expressed as a product. The idea is to factor n* into even powers of its 
prime divisors. The product representation is 


cay=[] (145+ 5+54--) 


p 


where the product is over primes p. To see why this works, consider the term (in the 
sum) 1/1207. We factor 120 as 23 x 3 x 5. Expanding the product representation, 
the term 1/60? appears by taking 1/2° from the first factor, 1/37 from the second, 
1/5* from the third, and 1 from all the other factors. 
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Notice that the factors in the product representation are geometric series. There- 





fore 
62) =T] (2 
P Pr 
and so 
1 1 
za W0- 7) 
as desired. 





5.9 Exercises 
5.1 Calculate (100), p(2°), and (5!). 


5.2. What is wrong with this program and how can the mistake be repaired? 


#include <iostream> 
using namespace std; 
int main() { 
int n; 
cout << "Enter n: "; 
cin >> n; 
int vals[n]; 
// do stuff with the vals array 
return 0; 


5.3 Solve the pair of congruences x = 3 (mod 20) andx =5 (mod 9). 


5.4 Write a procedure to solve problems such as Exercise 5.3. It may be declared 
like this: 


long crt (long al, long nl, long a2, long n2); 


(The name crt stands for Chinese Remainder Theorem.) 


The procedure should be designed to solve the pair of recurrences 
x=a, (mod n;) X=a) (mod n) 


where n, and ny are relatively prime positive integers. The return value is the 
solution mod njn2. 


How should the procedure handle a situation in which 1, and nj are not of this 
form? 
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5.5 In Program 5.7 we defined two values named blank and marked and used 
them to populate an array named theSieve. For the marks we used char 
type values (and the array was declared to be char«). However, it would be 
more logical to use boo1 values because each cell in theSieve takes only one 
of two possible values and the Boolean t rue or false makes perfect sense in 
this context. 


Why did we use char type values instead of boo1? 


5.6 Write a program that fills an array with Fibonacci numbers Fo through F29 and 
then prints them out in a chart. 


5.7 Write a program that fills two arrays a and b with integers according to this 
recurrence: 


a9 =bo = 1 An = by-1 Dy = An—1 + 2Dp-1. 


The program should then print out a table in which each row is of the form 


ak 
k ak by Po 
Dy 


Conjecture a value for limy_,.d,/b,. And, of course, prove your conjecture. 


5.8 Write a procedure to find the maximum value in an array of long integers. 
The inputs to the procedure should be the array and the number of elements in 
the array. The output should be the maximum value in the array. 


5.9 Write a procedure that generates an array of Fibonacci numbers as its return 

value. The input to the procedure should be an integer n > 2 that specifies 
the desired size of the array. Here is how such a procedure would appear in a 
main(): 
int main() { 

longs fibs; 

fibs = make_fibs(10); 

for (int k=0; k<10; k++) cout << fibs[k] << " "; 

cout << endl; 

return 0; 


This code should produce the output: 





P 
[2 1235813 21 34 55 


eee 





In addition, there is a subtle bug in the main (). What is it? 


5.10 Create a procedure long fibs(int n) to return the mth Fibonacci number. 
The procedure should work as follows. The first time the procedure is called, 
it creates a table of Fibonacci numbers holding F,, through F49. Then it returns 
the value held in the table it created. On all subsequent calls, it does not need 
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to recompute any Fibonacci numbers, but simply returns the value in the table 
it built during its first invocation. 


If the input parameter is out of range (either less than 0 or greater than 40) the 
procedure should return — 1. 


5.11 What happens when new asks for more memory than your computer can pro- 
vide? Write a program that repeatedly requests new for large blocks of mem- 
ory without ever releasing those blocks with delete []. That is, your program 
should have a severe, deliberate memory leak. 


5.12 A computational experiment yields the following result: 5. 8598744820. Pro- 
pose a conjecture. 


Part II 


Objects 


Chapter 6 





Points in the Plane 


The first part of this book introduces the fundamental data types (long, double, 
bool, etc.), arrays of these types, and procedures. 

C++ provides the ability to define new types of data that can be used just as the 
basic types are. New data types that we create are called classes. In this chapter we 
create a class called Point that represents a point in the Euclidean plane. When we 
want a variable to represent an integer quantity, we declare it to be type long (or one 
of the other integer types). Likewise, once we have the Point class set up, we can 
declare a variable to represent a point in the plane like this: 


Point X; 


We call x an object of type Point. 





6.1 Data and methods 


A class definition specifies the data that describe an object of the class and the 
methods to inspect and manipulate objects. 

For the class Point we need to hold data that specify a point’s location in the 
plane. There are two natural ways we might do this: rectangular coordinates (x,y) or 
polar coordinates (r,@). Later in this chapter, when we write the C++ files to create 
the Point class, we choose the rectangular representation. 

A class is more than a way to bundle data together. A class also specifies opera- 
tions that may be performed on its objects. Here are some things we might want to 
know about points and actions we might want to perform on points. 


e Learn a point’s rectangular coordinates (x and y). 


Learn a point’s polar coordinates (r and @). 


Change one (or both) of a point’s rectangular coordinates. 


Change one (or both) of a point’s polar coordinates. 


Rotate a point about the origin through a given angle. 


Check if two points are equal. 
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e Find the distance between two points. 
e Find the midpoint between two points. 
e Print a point’s coordinates using a statement of the form cout <<P<<end1;. 


We perform these various tasks by means of procedures. Many of the procedures 
are part of the definition of the class itself and are invoked by a different syntax. For 
example, we create a procedure to change a point’s x coordinate called set x. To set 
a point P’s x coordinate to —4.5, we use the following special syntax, 


P.setX(-4.5); 


The set X procedure is part of the definition of the class Point. Computer scientists 
call such procedures member functions but as we reserve the word function for its 
mathematical meaning, in this book we call such procedures methods. The term 
method is also used by many computer scientists. 

A C++ class is a bundle that combines data that describe its objects and methods 
for inspecting and manipulating the objects. 

Once a class is defined, we can use it in procedures just as with any other C++ 
data type. For example, here is a procedure named dist that computes the distance 
between two points. 
double dist (Point P, Point Q) { 

double dx = P.getX() - Q.getX(); 

double dy = P.getY() - Q.getY(); 


return sqrt (dx*dx + dyxdy); 
} 


Notice that dist is a procedure that works on two arguments (both of type Point) 
and returns a real number answer of type double. Inside this procedure we use 
Point’s getX and gety methods to access the x and y coordinates of the two 
points. (The sqrt procedure is defined in a C++ header file so this code requires 
a#include <cmath> directive.) 

The dist procedure is not a method (1.e., not a member of the Point class); it 
is simply a procedure that uses the Point data type. It is invoked using the usual 
syntax; to calculate the distance between two points we call dist (P,Q). However, 
getX is a method of the Point class; it is used to reveal the point’s x coordinate. 
Because it is a class method, it is invoked using the special syntax P. get X(). 

Let’s see how this all works. 





6.2 Declaring the Point class 


When we create a new procedure we break the definition into two files: a header 
file (whose name ends with .h) that declares the procedure and a code file (whose 
name ends with .cc) that specifies the algorithm. 


CAA DNMNAPWNKFK THUAN ANF WN 
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Likewise, a class is defined in two files: a .h file that declares the class anda .cc 
file that gives the algorithms for its various methods. 
The declaration for a class looks like this: 


class ClassName { 
declarations for data and methods; 
}; 


Notice the required semicolon after the class declaration’s close brace—it is easy to 
forget. 

We now present the declaration for the Point class. There are several new ideas 
present in this declaration and we examine each. As an aid to readability, we omit 
all the documentation from the file Point .h. It is extremely important to include 
comments in the header file that explain what the class represents and what each of 
its various methods does. The time you take to write these comments will be repaid 
tenfold when you subsequently write programs that use your classes. 

Here is the header file. 





Program 6.1: Header file Point .h for the Point class (condensed version). 


#ifndef POINT_H 
#define POINT_H 
#include <iostream> 
using namespace std; 


class Point { 


private: 
double x; 
double y; 


poruloyll eg 
Pomoc (()) 2 
Point (double xx, double yy); 
double getX() const; 
double getY() const; 
void setX(double xx); 
void setY(double yy); 
double getR() const; 
void setR(double r); 
double getA() const; 
void setA(double theta); 
void rotate(double theta); 
bool operator==(const Point& Q) const; 
bool operator!=(const Point& Q) const; 


}; 
Comb Wem catsies (> Ornate me Open tem @))e- 
Ixevligne, jiuvolexostine (ecaidic, 12 Rosia ©) 2 


ostream& operator<<(ostream& os, const Pointé& P); 


fendif 
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Let’s examine this file in detail. 


e To begin, lines 1, 2, and 33 are the usual mechanism to prevent double inclu- 


sion of the header file. 


The declaration of the Point class spans lines 6 through 27. Line 6 announces 
the declaration. The keyword class tells us that we are defining a new class 
that we have chosen to name Point. The open brace on line 6 is matched by 
the close brace on line 27, and the declaration is between these. The semicolon 
on line 27 ends the declaration. 


Ignore for now the keywords private, public, and const. We return to 
them subsequently. 


Lines 9-10 specify the data for objects of this class. The data are simply two 
real numbers giving the x and y coordinates; these are named (quite sensibly) 
x and y. 


Lines 13 and 14 declare the constructors for the class Point. A constructor is 
a method that is invoked when an object of type Point is declared. 


When a procedure contains a variable of type long, the variable must be de- 
clared before it can be used. Likewise, programs that use variables of type 
Point must declare those variables as such; a statement such as the following 
is required, 


Point P; 


This statement creates a variable named P and then invokes a method (named 
Point) that initializes the data held in P. In our case, this is extremely simple; 
the member variables x and y are set equal to zero. This basic constructor is 
declared on line 13; the code that sets x and y equal to zero is in another file 
(named Point .cc) that we examine in detail later. 


Line 14 declares a second constructor. This constructor takes two real argu- 
ments (named xx and yy). This constructor enables us to declare a point using 
the following syntax, 


Point Q(-3.2, 4.7); 
This declaration creates a new point at location (—3.2,4.7). 


Lines 17—23 declare the methods for the class Point. 


The methods get X and gety are used to learn the values held by x and y, and 
the methods set xX and set are used to modify the coordinates. 


Similarly, getR and getA are used to learn the point’s polar coordinates and 
setR and setA are used to change them. 


Methods to inspect and to modify the data held in an object are extremely com- 
mon. We need methods such as these because a well-designed class forbids 
direct access to its data. This is called data hiding. 
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Line 23 declares a procedure named rotate. Invoking rotate causes the 
point to be relocated at a new location by rotating the point about the origin 
through a specified angle. For example, if the point P is situated at coordinates 
(1,2), then after the statement P. rotate (M_P1I/2) ; the point will be located 
at (—2,1). (The symbol m_P1 is defined! in the cmath header; it stands for 
Tl.) 


e Lines 24—25 are operator declarations. C++ does not know how to compare 
two objects of type Point. If we want a statement of the form if (P==Q) ... 
in our program, we need to specify how points are to be compared. When C++ 
encounters an expression of the form P==Q or P! =Q, it needs to know exactly 
what to do. 


In the case of the class Point, the procedures are quite simple. We study these 
operators in detail later in this chapter. For now, please observe the ampersand 
(&) in the argument list; operators are invoked using call by reference. 


e Lines 29-31 are not part of the Point class declaration. These lines declare 
three procedures that are relevant to dealing with Points and could have been 
declared in a separate header file. However, it is more convenient to have 
everything pertinent to the Point class declared in the same file. 


The procedures on lines 29-30 are used to find the distance and midpoint be- 
tween two points, respectively. 


The procedure on line 31 is used in statements of the form cout << P;. This 
is explained later. 





6.3 Data hiding 


We now examine the keywords private and public in the declaration of the 
Point class. 

The declaration of the Point class is divided into two sections. The first section 
is labeled private: and under that label are the two data members of the class: x 
and y. There are no methods in Point’s private section. 

Data (and methods) in the private section are accessible only to the class’s meth- 
ods. For example, the get x and set y methods have access to the data x and y. Any 
other procedure (such as midpoint) cannot access anything that is in the private 
section. 

The reason for putting data in the private section is to protect those data from 
tampering. Tampering by whom? You, of course! For a simple class such as Point, 
there is not much that you can harm if you were able to manipulate the data directly. 


'The symbol M_PI might not be defined by all C++ compilers. 
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However, later when we build more complicated classes (such as Permutation), if 
you access the data directly you could easily put the object into an invalid state. 


Another reason for hiding your data (from yourself) is the ability to change the 
implementation. For the Point example, you may decide that it was a bad idea to 
save data in rectangular coordinates because the vast majority of your work is in 
polar. If your other programs were able to access directly the data in the Point 
class, you would need to rewrite all your programs were you to decide to change the 
internal representation of Point to polar. 


However, by hiding the data, your other programs cannot rely on how you repre- 
sent points. All they use are the various get and set methods. You can rewrite your 
class’s methods and then all programs that use the Point class will work. In a sense, 
other procedures that use Point won’t “know” that anything is different. 


The second part of the declaration follows the public: label. All of the methods 
in the public section are accessible to any procedure that uses objects of the Point 
class. It is possible to have a public data member of a class, but this is a bad idea. 
Because some classes (not yours!) do use public data, I will tell you how to use 
public data, but you must promise me that you will never make use of this ability in 
your own classes. 


Suppose we had placed x and y in the public section of the class declaration. If P 
is an object of type Point, then we could refer to the coordinates of the point using 
the notation P. x and P.y. For example, in lieu of 


Point P; 
P.setX(-4.2); 
P.setY(5.5); 


we could write 


Point P; 
P.x = -4.2; 
P.y = 5.5; 


Here is a mathematical analogy to data hiding. In analysis, all we need to know 
about the real number system is that it is a complete ordered field. Two analysts— 
let’s call them Annie and Andy—may have different preferences on how to define 
the reals. Annie prefers Dedekind cuts because these make the proof of the least 
upper bound property easy. Andy, however, prefers equivalence classes of Cauchy 
sequences because it is easier to define the field operations. In both cases, the an- 
alysts’ first job is to verify that their system satisfies the complete ordered field ax- 
ioms. From that point on, they can “forget” how they defined real numbers; the rest 
of their work is identical. The “private” data of real numbers is either a Dedekind 
cut or a Cauchy sequence; we need not worry about which. The “public” part of the 
real numbers are the complete ordered field axioms. 
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6.4 Constructors 


A constructor is a method that is invoked when an object of a class is declared. 
For example, the following code 


Point P; 


invokes the Point () constructor method for P. Recall (lines 13 and 14 in Pro- 
gram 6.1) that we declared two constructors for the Point class in the public sec- 
tion. The declarations look like this: 


Point (); 
Point (double xx, double yy); 


The first thing to notice is that the name of the method exactly matches the name of 
the class; this is required for constructors. 

The second thing to notice is that no return type is specified. It is not unusual for 
procedures not to return values, but such procedures are declared type void to desig- 
nate this fact. However, constructors are not declared type void and it is understood 
that they do not return values. 

We are ready to write the actual program for the Point constructors. The first ver- 
sion of the constructor takes no arguments. In a separate file (that we call Point .h) 
we have the following. 


#include "Point.h" 


Point::Point() { 

x=y =0.; 
} 
Please see Program 6.2, lines 4-6 on pages 109-110. The #include directive is 
necessary so the C++ compiler is aware of the Point class declaration. In a sense, 
the header file is an announcement of the class and the .cc file fills in the details. 

The name of the constructor is Point: :Point (). The first Point means “this is 
a member of the Point class” and the second Point means this is a method named 
Point. Because there is no return type and the name of the method matches the 
name of the class, it must be a constructor. 

The method’s action is simple; it sets the member variables x and y equal to zero. 
(The single line x = y = 0.; is equivalent to writing x = 0.; andy = 0.; as 
two separate statements.) 

Notice that x and y are not declared here because they are already declared in the 
class Point declaration. These are member variables of the class Point. Even 
though they are marked private, any method that is a member of the Point class 
may use these variables. 


There is a second constructor that accepts two arguments. The purpose of this 
constructor is so we may declare a variable this way: 


Point. O.(=521,. 03) 3 
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This statement declares a Point variable named Q in which x equals —5.1 and y 
equals 0.3. The code that accomplishes this is: 


Point (double xx, double yy) { 
xX = XX; 
Voeoyye 

} 


Notice that the arguments to this constructor are named xx and yy. Although C++ 
might allow it, we must not name these arguments x and y. We choose names that 


are similar to the names of the member variables x and y. Some people like the 
names x_ and y_ for such arguments, but these are more difficult to type. 





6.5 Assignment and conversion 


Constructors serve a second purpose in C++; they can be used to convert from 
one type to another. Recall that cout << 7/2; writes 3 to the screen because 7 
and 2 are integers. To convert 3, or an int variable x, to type double, we wrap the 
quantity inside a call to double as a procedure like this: double (7) or double (x). 

In the case of the Point class, we did not provide a single-argument constructor. 
However, we can convert a pair of double values to a Point like this: 


Point P; 
P = Point(-5.2, 4.2); 


The last statement causes an unnamed Point object to be created (with x = —5.2 
and y = 4.2) and then be copied into P. 

Here is another example in which one Point is assigned to another: 
Point P; 


Point Q(-2., 4.); 
P07 


When the first line executes, the point P is created and is located at (0,0) (this is 
the standard, zero-argument constructor). When the second line executes, the point 
Q is created as it is located at (—2,4). Finally, line three executes and the value of 
Q is copied to P. By default, C++ simply copies the x and y values held in Q to the 
corresponding data in P. Effectively, the assignment P = Q; is equivalent to the pair 
of statements P.x = Q.x; P.y = Q.y;. (Such statements cannot appear outside 
a method of the class Point because the data are private.) 

This is the default assignment behavior. Sometimes more sophisticated action 
must be taken in order to process an assignment; we explain when this is necessary 
and how it is accomplished in Chapter 11. 

There is no natural way to convert a single double to a Point, so we don’t define 
one. We could, however, decide that the real value x should be converted to the point 
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(x,0). In that case, we would add the line Point (double xx) ; to the declaration 
of the Point class (in Point .h) and add the following code to Point.cc. 


Point::Point (double xx) { 
xX = XX; 
y = 0.; 

} 


Had we done this, a main program could contain the following code. 


Point P; 
double x; 


P = Point (x); 





6.6 Methods 


We now examine the methods get X, set X, and so on. (See lines 15-23 of Pro- 
gram 6.1.) The first of these is declared double getX() const;. The word 
double means that this method returns a real value of type double. Next, get xX () 
gives the name of the method. The empty pair of parentheses means that this method 
takes no arguments. (We deal with const in a moment.) 

We specify the code for this method in the separate file Point .cc. Here are the 
relevant lines. 
double Point::getX() const { 


return x; 


} 


The beginning exactly matches the corresponding line in Point .h except for the 
prefix Point:: in front of getx. This prefix tells the C++ compiler that the code 
that follows specifies the get x method of the class Point. (If the Point: : prefix 
were forgotten, the compiler would have no way of knowing that this procedure is 
part of the Point class and would complain that x is undeclared.) 

The code couldn’t be simpler. The value in the member variable x is returned. This 
method is able to access x (even though x is private) because get X is a member 
of the class Point. 

Consider the following code. 


Point P; 
Point Q(4.5, 6.0); 
cout << P.getX() << endl; 


cout << Q.getX() << endl; 


The first call to get x is for the object P. In P, the variable x holds 0, and so 0 
is printed when the third line executes. The second call to getx is for a different 
object, 9. When it is invoked, the value 4.5 is returned because that is what is held 
in Q’s member variable x. 
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Next we consider the code for the set X method. In the header file, this was de- 
clared like this: void setX (double xx);. In Point.cc, the code for this method 
looks like this: 


void Point::setX(double xx) { 
X = XX; 


} 


The return type is void because this method does not return any values. The full 
name of the method is Point: :setx; the prefix identifies this as a method of the 
class Point. The method takes one double argument (named xx). Between the 
braces is the code for this method: we simply assign the value in the argument xx to 
the member variable x. 


There is an important difference between get xX and set x. The get X method does 
not alter the object for which it was called. The statement cout << P.getX(); 
cannot affect the object P in any way. We certify this by adding the keyword const 
in the declaration and definition of the get x method. When the word const appears 
after the argument list of a method, it is a certification that the method does not alter 
the object to which it belongs. If, in writing the Point::getx method we had a 
statement that could change the object (such as x = M_PI;), the compiler would 
complain and refuse to compile the code. 

Whenever you create a method that is not intended to modify the state of an object, 
include the keyword const after the argument list. 

Notice that the set x method does not include const after its argument list. This 
is because setxX is designed to modify the state of the object on which it is invoked. 


The definitions of the other get and set methods are similar; see lines 13-58 in 
Program 6.2. One special feature is the use of the atan2 procedure in getaA. The 
atan2 procedure is defined in the cmath header file. It is an extension of the usual 
arctan function. Calling atan2 (y, x) returns the angle to the point (x,y) regardless 
of which quadrant of the plane contains the point. (See Appendix C.6.1 for a list of 
mathematical functions available in C++.) 


Finally, we examine the rotate method; it is declared like this: 


void rotate(double theta); 


In polar coordinates, this method moves a point from (7, @) to (r,a@+ 6). 

To implement this method, we take advantage of the fact that we have already 
created the getA and setA procedures. We use the first to determine the current 
angle and the second to change that angle. 

Here is the C++ code in Point.cc. 
void Point::rotate(double theta) { 

double A = getA(); 

A += theta; 

setA(A); 

} 
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The return type is void because this method returns no value. The full name of 
the method is Point: : rotate which identifies this as a method in the Point class 
whose name is rotate. The method takes a single argument of type double named 
theta. The word const does not follow the argument list because this method may 
alter the object on which it is invoked. 

The first step is to figure out the current angle of this point; we do this by calling 
the getA() method. In, say, a main program, if we want to know the polar angle of 
a point P we would invoke the procedure like this: P. getA(). Here, we see the call 
getA() not appended to any object. Why? To what object does getA() apply? 

Remember that this code is defining a method for the class Point and is in- 
voked with a call such as P. rotate (M_PI) ;. Once inside the rotate procedure, 
a disembodied call to getA means, apply getA to the object for which this method 
was called. So, if elsewhere we have the call P. rotate (M_PI) ;, once we enter 
the rotate procedure, unadorned calls to getA refer to P. Likewise, the call to 
setA(A) on the penultimate line is applied to the object on which rotate was 
called. 

In other words, when we invoke P. rotate (t); (where t is a double and P is 
a Point), the following steps are taken. First a double variable named A is created 
and is assigned to hold the polar angle of P (which was calculated via a call to get A). 
Next, A is increased by t. Finally, the polar angle of P is changed via a call to set A. 
At the end (the close brace) the variable A disappears because it is local to the rotate 
procedure. 





6.7 Procedures using arguments of type Point 


There is nothing special about writing procedures that involve arguments of type 
Point. We declare two such procedures, dist and midpoint, in Point.h (lines 
30-31). They are declared outside the class declaration for Point because they are 
not members of the Point class. Recall that they are defined as follows. 


double dist (Point P, Point Q); 
Point midpoint (Point P, Point Q); 


The code for these procedures resides in Point.cc. Here we examine the code 
for midpoint. 


Point P, Point Q) { 
P.getX() + Q.getx() ) 
P.getY() + Q.getY() ) 

XX, YY); 


Point midpoint 
double xx = 
double yy = 
return Point 


} 


4-23 
[25 


Notice that we do not include the prefix Point:: in the name of this procedure; 
midpoint is not a member of the class Point. It is simply a procedure that is no 
different from, say, the gcd procedure we created in Chapter 3. 
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The procedure takes two arguments and has a return value, all of type Point. 
The code in the procedure is easy to understand. We average the two x and the two 
y coordinates of the points to find the coordinates of the midpoint. We must use 
the get xX procedure and we cannot use P.x. The latter is forbidden because this 
procedure is not a member of the class Point and so the private protection blocks 
direct access to the two data elements, x and y. 

The return statement involves a call to the two-argument version of the con- 
structor. An unnamed new Point is created by calling Point (xx, yy) and that 
value is sent back to the calling procedure. For example, suppose the main contains 
the following code. 

Point P(5,8); 


Point Q(6,2); 
Point R; 


R = midpoint (P,Q); 


When midpoint is invoked, copies of P and Q are passed to midpoint. Then 
midpoint performs the relevant computations using these copies and creates a point 
at coordinates (5.5,5). This return value is then copied to R. 

The repeated copying is a consequence of call by value. Because a Point does 
not contain a lot of data, we need not be concerned. (On my computer, call by value 
requires the passage of 16 bytes of data for each Point whereas call by reference 
only passes 4 bytes. This difference is not significant.) 

However, for larger, more complicated objects call by reference is preferable. In 
some cases, call by reference is mandatory; such is the case for the procedures we 
consider next. 





6.8 Operators 


C++ gives programmers the ability to extend the definitions of various operations 
(such as +, *, ==, etc.) to new data types. This is known as operator overloading. 

For the Point class, we overload the following operators: == for equality compar- 
ison, != for inequality comparison, and << for output. The first two are implemented 
in a different way than the third. 

We want to be able to compare two Points for equality and inequality. The mech- 
anism for doing this is to define methods for both the == and != operators. (In C++, 
these are called operators, although as mathematicians we might prefer to call them 
relations. In this book, we use the C++ terminology to stress the fact that when == is 
encountered, it triggers the execution of instructions.) 

The == operator takes two arguments (the Point variables to its left and right) 
and returns an answer (either true or false, i.e., a bool value). The declaration 
of == is inside the Point class declaration; see line 24 of Program 6.1. We repeat it 
here. 
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bool operator==(const Point& Q) const; 


Let’s examine this piece by piece. 


e The bool means that this method returns a value of type bool (i.e., either 
TRUE or FALSE). 


e The name of this method is operator==. The keyword operator means 
we are ascribing a meaning to one of C++’s standard operations. (You cannot 
make up your own operator symbols such as ««.) 


e The method takes only one argument, named Q. This is surprising because 

== seems to require two arguments (on the left and right). Because this is 

a member of the Point class, the left argument is the object on which it is 

invoked and the right argument is the object Q. That is to say, if the expression 

==B appears in a program, this method will be invoked with Q equal to B. 

Later, inside the code for ==, an unadorned use of x stands for A’s x. To use 
B’s data (which is the same as Q’s data), we use the syntax Q. x. 


e The type of Q is const Pointé Q. The Point means that Q is a variable 
of type Point. The ampersand signals that this is a call by reference. Call 
by reference is required for operators. This means that we do not copy the 
argument into a temporary variable named Q. Rather, Q refers to the variable 
that was handed to the method. 


The const inside the parentheses is a promise that this method does not mod- 
ify Q. 


e The keyword const appears a second time after the argument list. This const 
is a promise that the procedure does not modify the object on which it is in- 
voked. For the expression A==B, the trailing const is a promise that this 
procedure does not modify a. (The const inside the parentheses is a promise 
that B is unaltered.) 


(There is an alternative way to declare operators that use two arguments. We 
could have chosen to declare operat or== as a procedure that is not a member 
of the Point class. In that case, we would declare it after the closing brace of 
the class declaration. The declaration would look like this. 


bool operator==(const Pointé& P, const Pointé& Q); 


The decision to include == as a member of the class is somewhat arbitrary; it 
is mildly easier to write the code when it is a member of the class.) 


The declaration of the ! = operator is analogous. 


Now we need to write the code that is invoked when we encounter an expression 
of the form A==B. This code resides in the file Point .cc. Here it is: 
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bool Point: :operator==(const Pointé& Q) const { 
return ( (x==Q.x) && (y==Q.y) ); 
} 


The beginning of this code matches the declaration in Point .h. The only difference 
is that we prepend Point: : to the procedure name (operat or==) to signal that this 
is a member of the Point class. This also implies that the left argument of == must 
be a Point. 

The program has only one line. It checks if the x and y coordinates of the invoking 
object match those of Q. That is, the statement A==B causes this code to compare 
A.x to B.x and A.ytoB.y. The variable Q is a reference to B and the unadorned x 
and y refer to the data in A. 


The declaration for the != operator is nearly identical. Within the class declara- 
tion we have this: 


bool operator!=(const Point& Q) const; 


We could write the procedure (in Point .cc) this way: 


bool Point::operator!=(const Point &Q) const { 
return ( (x != Q.x) || (y != Q.y) ); 
} 


This works just as does the == operator; we compare the x and y coordinates of the 
two points to see if they are different. 

However, we present a different method for creating the != method. It is conceiv- 
able that the steps taken to check if two objects are equal are complicated. It would 
be useful if we could use the == method in defining the != method. We would simply 
see if the two objects are equal, and then compute the “not” of the result (using the 
! operator). 

The problem is this: Only one of the two arguments is named. In the declaration 
only the right hand argument to != has a name. The left argument is nameless. This 
does not create a problem if all we need to do is access the left argument’s data; 
we simply refer to the data elements by name. In x != Q.x the first x is the left 
argument’s x. How can we refer to the left argument in its entirety? The solution is 
this: Use *this. The expression «this is a reference to the object whose method 
is being defined. This enables us to build on the == procedure and use it in writing 
the != procedure. Here is the code (from Point .cc). 


nst Point &Q) const { 


bool Point: :operator!=(co 
=O); 


return ! ( («*this) = 


} 


The return statement first invokes the == method on two objects. The left-hand 
argument is *this referring to the object on which != is called and the right-hand 
argument is Q. For example, if this were invoked by the expression A!=B in some 
other procedure, then «this is A and Q is B. By is we mean that «this is not a copy 
of A, but A itself. Likewise, Q is not a copy of B, but is B itself. 

(Extra for experts: The expression *this consists of two parts: the operator « 
and the pointer this. The this pointer always points to the location that holds the 
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object whose method is being defined. The « operator dereferences the pointer; this 
means that «this is the object housed at location this. In other words, *this is 
the object for whom the current method is being applied.) 


The final operator we consider in this chapter is the << operator. We want to be 
able to write points to the computer screen with a statement of the form cout<<P;. 
The name of the procedure that does this is, not surprisingly, operator<<. However, 
we cannot declare this within the boundary of the class declaration because the 
object on the left is not of type Point. What is the type of cout? This has been 
hidden from you because cout is defined in the header file iost ream. 

The object cout is of type ost ream (which stands for output stream) and is de- 
clared in the header iost ream. Therefore, the expression cout << P contains two 
arguments: the left argument is of type ostream and the right is of type Point. 
Furthermore, the result of this expression is also of type ostream. A statement of 
the form 


cout << P << " is in quadrant I" << endl; 


contains the operator << three times. The order of operations rules for C++ (which 
you do not need to know) insert implicit parentheses into this expression to dictate 
the order in which the three different << procedures are called. With the hidden 
parentheses revealed, the expression looks like this: 


( (cout << P) << " is in quadrant I" ) << endl; 


The leftmost << is executed first. The effect of this operation is to print P on the 
screen (we see how that is done in a moment) and the result of the operation is to 
return cout. (We do not return a copy of cout, but the object itself—we explain 
how to do that in a moment.) 

After the first << executes and returns cout what remains is this: 


( cout << " is in quadrant I" ) << endl; 
Now the second << is called. The effect is to send the character array to the screen, 
and again cout is returned. Finally we are left with this: 


cout << endl; 
This causes the a new line to be started on the screen. 


With this background we are ready to declare and define the << operator for 
Point. In the file Point .h (but outside the class declaration) we have the fol- 
lowing (line 31 of Point .h). 


ostream& operator<<(ostream& os, const Pointé& P); 
Let’s examine this declaration piece by piece. 


e The return type of this procedure is ostream&. When we invoke the << op- 
erator via the expression cout << P the result of the procedure is cout, an 
object of type ostream. The ampersand indicates that this procedure returns 
a reference to (not a copy of) the result. We explain how this is accomplished 
when we examine the code. 
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e The name of this procedure is operator<<. 


e The procedure takes two arguments. The first is the left-hand argument to << 
and the second is taken from the right. 


The first (left) argument is of type ostream. We call this argument os which 
stands for “output stream”. Recall that << can be used with either cout or 
cerr; these are both objects of type ostream. The call is by reference, not 
by value. Objects of type ost ream are large and complicated; we do not want 
to make a copy of them. Furthermore, operators should be invoked using call 
by reference. This argument is not declared const because the act of printing 
changes the data held in the ost ream object. 


The second (right) argument is of type Point. Again, we use call by reference 
because that is what C++ requires for operators. Printing a Point does not 
affect its data; we certify this by flagging this argument as const. 


When we execute the statement cout << P, in effect we create a call that could 
be thought of like this: operator<<(cout,P). 


Next we write the code for the << operator. A nice format for the output is to print 
the two coordinates separated by a comma and enclosed in parentheses. Here is the 
code that makes this work. 


ostream& operator<<(ostream& os, const Pointé P) { 
os << "(" << P.getX() << "," << P.getY() << ")"; 
return os; 


} 


Watch what happens when we encounter the statement cout << A << endl;. The 
left << is executed first. We pass cout and A to the procedure. The first argument 
os becomes cout and the second argument becomes A. (Remember, in call by ref- 
erence, the arguments are not copies of the calling arguments, but the arguments 
themselves.) 

Effectively, the first line inside the procedure is this: 


cout << "(" << A.getX() << "," << A.getY() << ")"; 


(The argument os becomes cout and the argument P becomes A.) If A is the point 
(2,5), this line causes (2,5) to be written on the computer’s screen. 

The second line in the procedure returns os. Because the return type of this proce- 
dure is ost reamé (as opposed to plain ost ream), this return does not send a copy of 
os back to the invoking procedure; it sends os itself. In this example, os is precisely 
cout, So the result of this procedure is cout (and not a copy of cout). 

Therefore, after the first << in cout << A << endl; finishes, the statement is 
reduced to this: cout << endl;. 


To summarize, here is the file Point .cc in its entirety. 
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Program 6.2: Code for the Point class methods and procedures. 


#include "Point.h" 
#include <cmath> 


PornEt ceo inne t 
x =y=0.; 


Point::Point (double xx, double yy) 
x= ey 
ata oe 


double Point::getX() const { 
return x; 


double Point::getY() const { 
return y; 


void Point::setX(double xx) { 
xX = Xx; 


void Point::setY(double yy) { 
WE SANE 





double Point::getR() const { 
return sqrt (x*x + yxy); 





void Point::setR(double r) { 


{ 


yf Ti CNS PONE 1S at the origin, 


if ( (x==0.) && (y==0.) ) { 
DG SG 
return; 


// Otherwise, set position as (r cos A, 


double A = getA(); 
xX = r * cos(A); 
y =r * sin(A); 


double Point::getA() const { 


i? ( (==0.) && G==0.) ) vec O27 


double A = atan2(y,x); 
if (A<0O) A += 2*M_PI; 
return A; 


void Point::setA(double theta) { 


set location to 
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double r = getR(); 
xX = r * cos(theta); 
y =r * sin(theta); 


void Point::rotate(double theta) { 
double A = getA(); 
A += theta; 


setA(A); 

bool Point: :operator==(const Pointé Q) const { 
return ( (x==Q.x) && (y==Q.y) ); 

bool Point: :operator!=(const Point &Q) const { 
return ! ( («*this) == Q ); 





clormloikey elisie (A2@ulione 12, Iexealiote ~©)) 4 
double dx = P.getX() - Q.getX(); 
double dy = P.getY() - Q.getY(); 
return sqrt (dx*dx + dyxdy); 


Point midpoint (Point P, Point Q) { 
double xx = ( P.getX() + Q.getX() ) 
double yy = ( P.getY() + Q.getY() ) 
return Point (xx,yy); 


ostream& operator<<(ostream& os, const Pointé P) { 
os << "(" << PigetX() << "," << P.getYy() << ")"; 
return Os; 





Once a class has been created (or even during its development) it’s important to 
test its features. Here is a program to check the various aspects of the Point class. 





Program 6.3: A program to check the Point class. 


#include "Point.h" 
#include <iostream> 
using namespace std; 


[*x* 
af teen he teat sine Point class, 
*/ 
int main() { 
Point x; // Test constructor version 1 
Point. Yis,ee 4f Test censtructor verei on. 
CouUL «4 CIS pornkeses: “ack ee send thermore. cy as.” 
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Sete REG) ee NCCE ANS) Daou) <a omcill: 


cout << "The distance between these points is " 


<< dist(X,Y) << endl; 


cout << "The midpoint between these points is " 


KS wibohoouiae (6%) «<< einecliky 


Y.rotate (M_PI/2); 


cout << "After 90-degree rotation, Y = " << Y << endl; 
Y.setR(100); 
cout << "After rescaling, Y = " << Y << endl; 


Y.setA(M_PI/4); 


cout << "After setting Y’s angle to 45 degrees, Y = " << Y << endl; 
Point 2; 
Z= Y; // Assign one point to another 
cout << "After setting Z = Y, we find Z =" << Z << endl; 
p Gees are His (ey ecm yt: 
Lo Pont (oy 3)5 
cout <<. “Now Point x is 9 xq kee Y cand point x as * <4 Y <2 endly 
if (X==Y) { 
cout << "They are equal." << endl; 
} 
crises (XG Fae Va) ia 
cout << "They are not equal." << endl; 


return 0; 





The output of this main follows. 








The point X is (0,0) and the point Y is (3,4) 


Point 


Y in polar coordinates is (5,0.927295) 


The distance between these points is 5 
The midpoint between these points is (1.5,2) 


After 
After 
After 
After 


90-degree rotation, Y = (-4,3) 

rescaling, Y = (-80,60) 

setting Y’s angle to 45 degrees, Y = (70.7107,70.7107) 
setting Z = Y, we find Z = (70.7107,70.7107) 


Now point X is (5,3) and point Y is (5,-3) 
They are not equal. 
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6.9 Exercises 


6.1 To complement the Point class created in this chapter, create your own Line 
class to represent a line in the Euclidean plane. The class should have the 
following features. 


Because every line in the Euclidean plane can be represented by an equa- 
tion of the form ax + by +c = 0 (where a and b are not both zero), the 
Line class should hold three private data elements: a, b, and c. 


The class should include the following constructors. 
— A zero-argument default constructor. Choose a sensible behavior for 
this constructor (e.g., construct the line y = 0). 


— A two-argument constructor whose input arguments are both type 
Point. Of course, this should create the line through these points. 
Hint: In order for the Line class to use Point objects, you need to 
have #include "Point.h" at the top of your Line.h file. 

— A three-argument constructor whose double arguments are simply 
assigned to a, b, and c. 


In the latter two cases, give sensible behaviors in the event that the user 
gives bad inputs (either the two points are the same or a= b = 0). 


Include get methods to inspect the values held in a, b, and c. 


Include methods named reflectX() and reflecty() that reflect this 
Line through the x- and y-axis, respectively. 


Include a method to check if a given Point is on the Line. 
Include a method that generates a Point on the Line. 


Include an == operator to check if two Line objects are the same. 


Note: This is not as simple as checking that a, b, and c are the same for 
the two lines. 


Include an operator << for printing a Line to the screen (e.g., cout<<L; 
where L is type Line). Pick a sensible format for the output. 


Include a procedure (not a method in the class) that calculates the dis- 
tance between a Point and a Line. The procedure should accept the 
two arguments in either order: dist (P,L) or dist (L,P). 

Hint: The standard C++ procedures sqrt (x) (for \/x) and fabs (x) (for 
|x|) may be of assistance here. Some systems may require the directive 
#include <cmath> to use these. See Appendix C.6.1. 


6.2 To test the Line class from Exercise 6.1, a programmer wrote the following 


code. 


6.3 


6.4 
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#include "Line.h" 
#include <iostream> 
using namespace std; 


int main() { 
Point X(5,3); 
Point Y(-2,8); 
Line L(X,Y); 


cout << "X "<< X << endl; 


cout << "Y = " << Y << endl; 

cout << "The line L through X and Y is " << L << endl; 
Point Q; 

Q = L.find_Point (); 

cout << "0 =" << Q << " is a point on L" << endl; 

Line M(X,Q); 

cout << "The line M through X and Q is " << M << endl; 
cout << "Are lines L and M the same?\t" << (L==M) << endl; 


cout << "Is Y incident with M?\t" << M.incident(Y) << endl; 
cout << "Distance from Y to M is zero?\t" 

<< (dist (Y,M)==0) << endl; 
return 0; 


In this program, we establish two points X = (5,3) and Y = (—2,8), and the 
line L through them. 


Next we construct a point Q on L and then we construct another line M through 
X and Q. Because the points X, Y, and Q are collinear, it must be the case that L 
and M are the same line. However, when the code is run, we see the following 
output. 








x (5,3) 

YS (225.8) 

The line L through X and Y is [5,7,-46] 

Q = (0,6.57143) is a point on L 

The line M through X and Q is [3.57143,5,-32.8571] 
Are lines L and M the same? 0 

Is Y incident with M? 0 

Distance from Y to M is zero? 0 








The program reports that L 4 M, that Y is not on the line M, and that Y is 
a nonzero distance away from M. All of these are mathematically incorrect. 
What’s wrong? How might these problems be addressed? 


In the Line class developed in these exercises, we represent a line as a triple 
(a,b,c) standing for the equation ax+ by+c=0. Alternatively, we could 
represent a Line as a pair of Points. How would the header and code files 
for the Line class need to be modified were we to decide to switch to this 
alternative? How would programs that use the Line class need to be modified? 


Create a procedure to test if two Line objects represent intersecting lines and, 
if not, to find their Point of intersection. 
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Create a LineSegment class. The data for the class should be two Point 
objects representing the end points of the segment. You may consider making 
these data elements public even though this practice is usually discouraged. 
Why might this be acceptable in this case? 


Suppose we wish to adda translate method to the Point class developed in 
this chapter. The effect of invoking P. translate (dx, dy) would be to move 
the point from its current location (x,y) to the new location (x+dx,y+dy). In 
addition (and this is the point of this exercise), this method should return the 
new value of P. For example, consider this code: 


Point P(4,5); 
cout << P.translate(1,2) << endl; 


This should print (5,7) on the computer’s screen. 


This procedure is declared by adding the following line to the public section 
of the Point declaration in Point .h. 


Point translate(double dx, double dy); 


Explain how to code this procedure in the Point .cc file. 


In Exercise 6.6 we considered how to add a translate procedure to the 
Point class. With this addition in place, consider the following code in a 
main(). 

Point P(3,5); 


(P.translate(1,2)).translate(10,10); 
cout << P << endl; 


This causes (4,7) to be printed on the screen. 


We might have expected (14,17) to have been printed. Explain the behavior 
of the code. 


How can you modify the code to achieve the desired behavior. 


Hint: Normally a return xX; statement returns a copy of x. Examine how we 
coded operator<< for the Point class to implement a different behavior for 
return. 


Chapter 7 





Pythagorean Triples 


A Pythagorean triple is a list of three integers (a,b,c) such that a* +b? = c*. Such 
a triple is called primitive if the integers are nonnegative and gced(a,b,c) = 1. For 
example, (3,4,5) is a Pythagorean triple because 3? + 4* = 57. Although (30,40, 50) 
and (—3,4, —5) are also Pythagorean triples, they are not primitive. 

In this chapter and the next we develop the C++ machinery necessary to find all 
primitive Pythagorean triples with a,b,c < 1000 (or any other given value). 





7.1 Generating Pythagorean triples 


There is a simple method to generate Pythagorean triples. Let z be a Gaussian 
integer; that is, z= m-ni where m,n € Z. Consider |z*|. On the one hand, 


Iz] = (le?) = (ov? +?) 


but 


|z4| = 2” = | (m? —n’)+ (2mn)i\” = (m? —n?)* + (2mn)?. 


Therefore 


(m? —n)? + (2mn)? = (m? +n7)’. («) 


Because m,n € Z, it follows that (m? —n?,2mn,m? +n) is a Pythagorean triple. 
This can also be checked directly by expanding both sides (x). 


Although every triple of the form (m? —n?,2mn,m? + n) is a Pythagorean triple, 
not all Pythagorean triples arise in this manner. For example, (9, 12,15) cannot be so 
expressed. [Proof. If (9,12,15) were of this form, then 2mn = 12, so mn = 6. This 
implies that {m,n} = {+2,+3} or {+1,+6} none of which yields (9, 12, 15).] 

However, it can be shown that every primitive Pythagorean triple is of the form 
(m? —n?,2mn,m? + n’), We use this as fact to create a class that represents primitive 
Pythagorean triples. 
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7.2 Designing a primitive Pythagorean triple class 


We want to design a C++ class to represent primitive Pythagorean triples. The 
first question is: What shall we call this class? The most descriptive name is the 
verbose PrimitivePythagoreanTriple but it would be painful to have to type 
that repeatedly. On the other extreme, we could call the class PPT, but that would be 
too cryptic. We settle on a compromise solution: PTriple. 

How shall a PTriple store its data? The easiest solution is to save the triple 
(a,b,c). Although we could omit c because it can be calculated from a and b, the 
small bit of extra memory used by keeping c also is not a problem. We don’t want 
to consider (3,4,5) different from any permutation of (3,4,5), so let us agree that a 
PTriple should hold the three integers in nondecreasing order. The three integers 
are held in long variables named a, b, and c. 

Every class needs a constructor. Based on our discussion, the constructor should 
process a pair of integers (m,n) to produce the triple (m* — n?,2mn,m? + n*). Un- 
fortunately, life is not as simple as assigning 


ac mn —n’, b<—2mn, and c —m +n’, 
To begin, this may result in a or b negative. Even if both are positive, they may be in 
the wrong order (we want 0 < a < b). Finally, the three values might not be relatively 
prime. The only thing of which we can be confident is that m? +n? is nonnegative 
and the largest of the three. 

To handle these issues the constructor needs to correct the signs of a and b, put 
them in their proper order, and divide through by gcd(a,b). 

One last worry. In case m = n = 0, the triple constructed would be (0,0,0). Tech- 
nically, this is not primitive because the entries are not relatively prime. We have two 
choices: we can allow (0,0,0) to be a valid PTriple or we can forbid it. In either 
case, the constructor needs to treat this possibility as a special case. In this book, we 
decide to allow (0,0,0) as a valid PTriple. 

We also need to provide a constructor with no arguments. This is what is invoked 
by a declaration of the form PTriple P;. What Pythagorean triple should this 
create? In other words, what should be the default primitive Pythagorean triple? 
There are three natural choices: (0,0,0), (0, 1,1), or (3,4,5). The last is the smallest 
triple in which none of the elements is zero. For better or worse, we decide that 
(0,0,0) is the default. If you are unhappy with any of these decisions, you can 
certainly choose to proceed differently. 

What methods do we need? We need to know the values held in a, b, and c, so 
we plan for methods getA(), getB(), and getC() to report those values. We do 
not want methods that can alter these values because we do not want to allow a user 
to put a PTriple into an invalid state. If we had a seta method, then P.setA(2) ; 
would result in a PTriple that cannot possibly be a Pythagorean triple. 

We also want operators to compare PTriples. In addition to the == and != oper- 
ators, we define a < operator. We need a less-than operator so we can sort PTriples 
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in an array and remove duplicates. (Remember, our goal is to find all primitive 
Pythagorean triples with O << a<b<c<_ 1000.) We have some choice as to how 
to define < for PTriples; we just need to ensure that our definition of < results in 
a total order. One simple solution is to order the triples lexicographically. We put 
(a,b,c) < (a’,b’,c’) provided c < c’, or else c= c' and b < b’. Of course, if c = c’ 
and b = b’, then a = a’ and the triples are identical. 

Finally, it is useful to define the << operator so we can print PTriples to the 
computer’s screen. 

We are now ready to implement the PTriple class. 





7.3 Implementation of the PTriple class 


As planned, the PTriple class has three private data elements of type long 
named a, b, and c. The constructors ensure that the following conditions are always 
met. 

0<a<b<ce, gced(a,b) = 1, a+b =c’. («) 


The only exception is that we allow (a,b,c) = (0,0,0). 

We create the class with two constructors: one that takes no arguments and one 
that takes two long arguments. The first constructs (0,0,0) and the latter uses the 
method described at the beginning of the chapter. It is the constructor’s responsibility 
to make sure that the conditions in («) are met. We relegate that to a private helper 
method named reduce. (Strictly speaking, we do not need a separate procedure for 
these steps, but we want to illustrate an instance of a private method for a class.) 

The public methods for PTriple are getA, getB, getC, and the operators ==, 
!=, and <. Finally, we have an operator<< procedure that is not a member of the 
PTriple class. 

We now present the header file PTriple.h. In this case, we have not removed 
the comments. This header file introduces some new ideas that we discuss after we 
present the file. 








Program 7.1: Header file for the PTriple class. 


#ifndef PTRIPLE_H 
#define PTRIPLE_H 
#include <iostream> 
using namespace std; 
[xx 

A PTriple represents a reduced Pythagorean triple. That is, a 
sequence of three nonnegative integers (a,b,c) in nondecreasing 
order for which a*2+b°2=c"2 and (a,b,c) are relatively prime. The 
relatively prime requirement means that we only deal with primitive 
Pythagorean triples. We allow (0,0,0). 
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class PTriple { 
private: 


/// Shorter leg of the triple 
long a; 

/// “Longer leg of the triple 
long b; 

/// Hypotenuse 

leisy tay 


/** 

x This private method makes sure the triple elements are 

* nonnegative, in nondecreasing order, and relatively prime. 
*/ 


void reduce (); 


porloyll e.g 


[*x* 
* Default constructor. Makes the triple (0,0,0). 
x/ 

PTriple() { 
a=b=ce=0; 


— 


Construct from a pair of integers. Given integers m and n, we 
make a Pythagorean triple by taking the legs to be 2mn and 
m°2-n°2 and the hypotenuse to be m*2+n”2. We then make sure the 
three numbers are nonnegative, in nondecreasing order, and then 
divide out by their gcd. For example PTriple(2,1) creates the 

* famous (3,4,5) triple. 

x/ 
PTriple(long m, long n); 


/// What is the shorter leg of this triple? 
long getA() const { 
TOSI WAIN wie 


/// What is the longer leg of this triple? 
long getB() const { 
return b; 


/// What is the hypotenuse of this triple? 
long getC() const { 
weSieibiiaigy (eg 





oS 


Check if this PTriple is less than another. The ordering is 
lexicographic starting with c, then b. That is, we first compare 
hypotenuses. If these are equal, then we compare the longer leg. 
@param that Another PTriple 

* @return true if this PTriple is lexicographically less than that. 
*/ 


bool operator<(const PTriple& that) const; 
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[*x 
x Check If this Piriple is equal co Anether, 
x/ 
bool operator==(const PTriple& that) const { 
return ( (a==that.a) && (b==that.b) && (c==that.c) ); 
} 
[*x* 
x Check if this PTriple is not equal to another. 
x/ 
bool operator!=(const PTriple& that) const { 
return !( («this) == that ); 


hi 


/// Send a PTriple to an output stream 
ostream& operator<<(ostream& os, const PTriple& PT); 


#endif 





The class declaration begins on line 13. Within the private section we see the 
three long variables that hold the triple’s data. Thinking of a right triangle with side 
lengths a,b,c, we call a the shorter leg, b the longer leg, and c the hypotenuse. 

Also within the private section is the reduce() method. This is a method 
invoked by the two-argument constructor PTriple (m,n); we discuss this in more 
detail below. 

The public section begins on line 28 beginning with the two constructors. The 
zero-argument constructor PTriple() is not declared in the way we expect. Nor- 
mally, a procedure declaration does not include the procedure’s code. All we expect 
is this: 

PTriple(); 


Instead, we see what we would normally expect to find in the . cc file. 
PTriple() { 

a=b=c=0; 
} 
This is a special feature of C++. Procedures may be defined in header files and 
are known as inline procedures. An inline procedure combines the declaration and 
definition of a procedure at a single location in the header file. 

It is possible to make any procedure into an inline procedure. The keyword 
inline is used to announce this fact. However, for procedures that are members 
of classes (i.e., methods), the keyword is optional. For all other procedures (i.e., or- 
dinary procedures that are not class members), the inline keyword is mandatory. 


When should you use inline procedures as opposed to the usual technique of a 
declaration in the .h file and definition in the .cc file? If the method’s code is only 
a line or two, then it is a good idea to write it as an inline procedure. Several of 
PTriple’s methods are extremely short and we write those as inline procedures as 
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well. Others (such as the two-argument constructor or the operator<) are more 
involved, so we use the usual technique for those. 

There are advantages and disadvantages to writing inline code. It is convenient to 
write the code for a method in the same file where it is defined. The C++ compiler 
produces more efficient code from procedures that are written inline. (However, 
smart C++ compilers can figure out when it is worthwhile to convert an ordinary 
procedure into an inline procedure.) However, the object code for programs that use 
inline procedures takes up a bit more disk space. Also, it takes a bit more time to 
compile programs with inline procedures. 

Sometimes it is mandatory to write methods as inline procedures. We explain that 
when the time comes (Chapter 12). 


The procedures that are not specified by inline code in the header file are defined 
in the file PTriple.cc that we present next. 





Program 7.2: Program file for the PTriple class. 


#include "PTriple.h" 
#include "gcd.h" 


Piriple-:-Clriple(long mm, long nm) 41 
a = 2x*mx*n; 
b = mem —- nen; 
c = m*xem + nxn; 


reduce (); 


} 


void PTriple::reduce() { 
// Nothing to do if a=b=c=0 
if ((a==0) && (b==0) && (c==0)) return; 


// Make sure a,b are nonnegative (c must be) 
ct Tat (<0) Weecle— ae cli 
fiat (<<0) oman sloyr 


// Make sure a <= b 
Subs Whee 
long tmp = a; 
a=b; 
b = tmp; 
} 


// Make sure a,b,c are relatively prime 
long d = gcd(a,b); 


a /=d; 
b /= qd; 
c/a, 


} 


bool PIriple: toperator< (const PTriples that) const { 
Lp oe VES aera sre: 
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we (lo < laste Jo) wei ieieUSS 
return false; 


} 


ostream& operator<<(ostream& os, const PTriple& PT) { 
Os << Ul << PI ye@era() << Yi" << praceiciss()) —K 7 
<< PU gece) << Wis 
return Os; 


} 





The code for the constructor PTriple (m,n) is broken into two parts. Given the 
input integers m,n we set 


a 2mn, bem —-nr’, and com +n’. 


Then we need to fix a few things up. We need to make sure that a and b are non- 


negative, that a < b, and that gcd(a,b,c) = 1. We relegate these chores to the private 
reduce method (which is invoked by the PTriple constructor on line 9). 


The code for the < operator follows. This operator is used to compare a given 
PTriple with another. If R and P are variables of type PTriple, the expression 
R<P causes the operator< procedure belonging to R to execute. 

We first compare the c values of R and P; this happens on lines 35-36. The first 
comparison is c < that.c. The first c is the hypotenuse of the left-hand argument 
of < (i.e., R). The unadorned c refers to the c for the object on which the method was 
invoked. The c of the right-hand argument needs to be specified, so we must refer to 
it as that .c because the right-hand argument is named that. Because P is passed 
by reference (required for operators) to <, that .c is exactly the same variable as 
Pi, 

In short: When R<P is encountered, the unadorned c on line 35 is the c data 
member of R and the that .c on line 35 is the c data member of P. 





7.4 Finding and sorting the triples 


Our goal is to find all primitive Pythagorean triples (a,b,c) wih0O <a<b<c< 
1000. Our strategy is this. 


e First, we create an array of PTriples by calling PTriple (m,n) over a suit- 
ably large range of m and n. Because every primitive Pythagorean triple can be 
obtained from (m? — n*,2mn,m? +n?) we do not need to consider values of m 
orn greater than vy 1000. 


The upper bound of 1000 is, of course, arbitrary. Our design permits an arbi- 
trary upper bound of N. 
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e As the Pythagorean triples are created, we save them in an array. Because the 
upper bound on a,b,c is arbitrary (N is specified by user input), the array we 
create needs to be dynamically allocated. 


How big should this array be? In the worst-case scenario, all of the Pythagorean 
triples we create might be primitive and different from one another. (This is 
actually a gross overestimate, but serves our purposes.) Because we iterate 
over all m andn with 1 <mn< JN, an array that can accommodate N values 
is large enough. 


e Once the array is populated, we sort it. It was in anticipation of the need to 
sort the array that we defined the < operator. 


e Finally, we read through the array printing out unique elements. 


Here is the program that does all those steps; we explain the key features after we 
present the code. 





Program 7.3: A program to find Pythagorean triples. 


#include "PTriple.h" 

#include <iostream> 

#include <cmath> 

using namespace std; 

[*x* 

* Find all primitive Pythagorean triples (a,b,c) with 0 <= a <= b <= 
* c <= N where N is specified by the user. 


x/ 

int main() { 
PTriple* table; // table to hold the triples 
long N; // upper bound on triples. 


// Ask the user for N 


cout << "Please enter N (upper bound on triples) --> "; 
Calin SS INS 
etn (Nie<— 20) eee cura 0} // nothing to do when N isn’t positive 


// Allocate space for the table 
table = new PTriple[N]; 





// Populate the table with all possible PTriples 
long idx = 0; // index into the table 
long rootN = long( sqrt (double(N)) ); 


for (long m=1; m<=rootN; mt+) { 
for (long n=1; n<=rootN; n++) { 
PTriple P = PTriple(m,n); 
it (P getty <= NN) 4 
table[idx] = P; 
TLGParse Pp 
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// Sort the table 
sort (table, tabletidx); 


// Print out nonduplicate elements of the table 
cout << table[0] << endl; 
inoue ((aiiaic Keeike le<sebo aras)} 4 


} 


if (table[k] != table[k-1]) { 
cout << table[k] << endl; 


// Release memory held by the table 
delete[] table; 
return 0; 





Note: Some compilers may require #include <algorithm> in order to use the 
sort procedure (line 37). 


Now for the analysis of the code. 


We need a table to hold the PTriples and so we declare a variable table of 
type PTriplex (pointer to a PTriple, ie., the head of an array). Because 
we do not know how large this array needs to be, we cannot declare it with a 
statement of the form PTriple table[1000];. 


Lines 15-17 ask the user to give us an integer N. If the user gives us an integer 
that is less than 1, we end the program. 


Line 20 allocates space for table. 


The variable idx, declared on line 23, is used to access elements in the array 
table. 


The variable rootN is set to | VN |. The syntax, unfortunately, is awkward. 
The C++ sqrt procedure (which may require #include <cmath>) takes and 
returns values of type double. So we first need to cast the value of N into a 
double, calculate its square root, and then cast back to type long. When a 
doub1le is converted into a long, the digits to the right of the decimal place 
are discarded. Therefore, line 24 computes the desired | VN : 


Lines 26-34 run through all possible values of m,n with 1 <m,n < VN. For 
each pair, we generate a primitive Pythagorean triple. If its c-value is no larger 
than N (line 29) we insert its value in the table and increment idx. Therefore, 
once we finish this double for-loop, the variable idx holds the number of 
entries we made into the array table. 


Sorting of the table takes place on line 37. The C++ sort procedure can 
be used on any array of elements provided the type of those elements can be 
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compared with a < operator. Thus, sort can be used to sort an array of longs 
or doubles. In order to sort an array of PTriples, we just need to provide a 
< operator. 


The sort procedure may require the algorithm header. 


The sorting is invoked with an unusual syntax: sort (table, table+idx) ;. 
The first argument, table, makes sense. The sort procedure needs to know 
what array to sort. It’s the second argument that is difficult to understand. 


The second argument to sort needs to be a pointer to the location of the first 
element beyond the end of the array. In other words, if the array holds five 
elements (indexed 0 through 4), then the second argument to sort needs to be 
a pointer to the nonexistent sixth element of the array (index 5). 


More generally, sort can be used to sort a contiguous block of elements of an 
array. The first argument to sort should be a pointer to the start of the block 
and the second argument should be a pointer to the first element after the end 
of the block. 


We know that table is a pointer to the first element of the array table. That 
is, table holds the memory address of table[0]. In C++, table+1 eval- 
uates to the address in memory that holds table[1]. So tabletidx is the 
memory location holding table [idx]. However, at this point in our pro- 
gram, idx holds a number one greater than the location where we last placed 
aPTriple. This is what sort wants and so this is what we do. 


Bottom line: To sort an array named, say, table that contains, say, 25 ele- 
ments, the statement we use is this: sort (table, table+25);. Its OK to 
forget all this discussion about pointers and just remember this: 


sort ( table_name, table_name + number_of_elements) ; 


Lines 40-45 step through the elements of table. If the current element is 
different from the previous one, we print it. 


Finally, we release the memory allocated to table on line 48. Strictly speak- 
ing, this isn’t necessary because we are at the end of the program; the memory 
would be reclaimed automatically. Nevertheless, it is a good habit to be sure 
every new is matched with a delete[]. 


Here is what we see when the program is run (for N = 100). 








Please enter N (upper bound on triples) --> 100 


( 
( 
( 
( 
( 
( 
( 
( 


0,1,1) 

3,4,5) 

5,12,13) 
8,15,17) 
7,24,25) 
20,21, 29) 
12,35,37) 
9,40, 41) 
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(28,45, 53) 
(11,60, 61) 
(33,56, 65) 
(16, 63, 65) 
(48,55,73) 
(36, 77,85) 
(13, 84,85) 
(39, 80,89) 
(65, 72,97) 





ey) 





We see that there are 17 primitive Pythagorean triples with O <a<b<c< 100. 
This implies that the array we created, table, used more memory than we really 
needed. 

Let’s complain about this program. 


e It wastes memory. This is not a terrible problem because holding hundreds, or 
even hundreds of thousands of Pythagorean triples is well within the capacity 
of even the most modest computers. Still, we may encounter other situations 
in which we need to be careful about the amount of memory we use. 


e It was annoying that we needed to figure out how much memory to set aside 
in table. It would be much easier if the table could adjust its size to suit our 
needs, rather than requiring us to figure out how big to make it. 


e The call to sort is still bugging me. Adding an object of type PTriple» and 
an object of type long just seems wrong. (It isn’t wrong, but it is confusing.) 


We deal with all these complaints in the next chapter. 


7.5 Exercises 


7.1 Create an Interval class to represent closed intervals on the real line: [a,b] = 
{x €R:a<x <b}. Implement this class entirely within an Interval.h file 
and without any code file. To do this, you will need to make all methods and 
procedures inline. 


The class should include the following features. 
(a) Two constructors: a zero-argument constructor that creates a default in- 
terval (say, [0,1]) and a two-argument interval that creates the interval 


with the specified end points. In response to either Interval (3,4) or 
Interval (4, 3), the interval [3,4] should be constructed. 


(b) Get methods to reveal the end points of the interval. 


(c) Comparison operators for equality (==) and inequality (! =). 
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(d) An operator< for lexicographic sorting of the intervals. That is, [a,b] < 
[c,d] provided a <c or (a=candb<d). 


(e) An operator<< for output to the screen. 


In Exercise 7.1 you created an Interval class. Use that class to investigate 
the following problem. Let [,,h,...,/, be a collection of random intervals. 
What is the probability that one of these intervals intersects all of the others? 


By random interval we mean an interval whose end points are chosen indepen- 
dently and uniformly from [0, 1] (with the understanding that [a,b] = [b,a}). 


Write a program that generates n random intervals and then checks to see if 
one of those intervals meets all of the others. It should repeat this experiment 
many times and report the frequency with which it meets success. 


Write a procedure that finds the median in a list of real numbers. Declare the 
procedure as 


double median(const double* array, long nels); 


where array is the list of values and nels is the number of elements in the 
array. 


Warning: Your procedure should not modify the list (hence the use of the 
keyword const), but should use its values to find the median. Still, a good 
way to find the middle element(s) is to work with a sorted array. If you wish 
to use the C++ sort procedure, include these lines in your code: 


#include <algorithm> 
using namespace std; 


Note: If the length of the list is even, there is no single middle value, but rather 
two “middle” values. In this case, take the median to be the average of those 
two middle values. 


Write a program to count the number of primitive Pythagorean triples in which 
(a) one of the legs has length k and (b) in which the hypotenuse has length k, 
for all k with 1 <k < 100. 


Chapter 8 


Containers 


In this chapter we explore a variety of container classes available in C++. The C++ 
arrays provide little functionality and can be difficult to use. It is easy to make 
mistakes using arrays: the arrays might not be big enough to hold the data, we might 
access elements beyond the end of the array, there is no convenient way to enlarge 
an array after it has been created, and it is easy to forget a delete|[ ] statement for 
an array that has been dynamically allocated. 

In lieu of holding values in arrays, C++ provides the means to create arraylike 
structures that can change size on demand, unordered collections (sets and multisets), 
and other useful containers (stacks, queues, double-ended queues, and simple lists). 
These containers are easy to use. 


8.1 Sets 


In Chapter 7 we generated primitive Pythagorean triples and collected our results 
in an array. We then needed to process the array to remove duplicates. Alternatively, 
with each new triple generated, we could have scanned the array to see if the new 
triple was already recorded. This, however, increases the processing time and does 
not solve the problem that we do not know in advance how large to make the array. 

The C++ set class behaves much as a finite mathematical set. In a C++ set, all 
the elements of the set must be the same type. That is, the elements of the set may 
be all longs or all PTriples; the set cannot contain a mixture of types. 

To use sets in your program, you need to include the set header file with the 
directive #include <set>. 

To declare a set one needs to specify the type of element stored in the set. This 
is done using the syntax set<type> set_name;. For example, to declare a set of 
integers, use the following statement, 


set<long> S; 


The variable S is now a set that can hold long integer elements. Any C++ type 
(either innate or a class you define) can be held in a set with only one proviso: The 
type must have < and == operators defined. 

There are fundamental operations we need to be able to perform on sets such as 
adding an element to a set, deleting an element from the set, and so on. Here are the 


127 


128 C++ for Mathematicians 


important methods you need to know to use C++ sets. In each case, S$ and T stand for 
sets of elements of some type, and e stands for variable of that type. (For example, 
S and Tare sets of longs and e is a long.) 


Add an element Use the statement S.insert(e);. This causes a copy of e to be 
inserted into the set unless, of course, the set already contains this value. 


Delete an element Use the statement S.erase(e);. If the set contains the value 
held by e, that value is removed from the set. If the value is not in the set, 
nothing changes. 


Delete all elements in a set Use the statement S.clear() ;. 


Is an element in the set? Use the method S.count(e). This returns the number 
of times that e’s value appears in the set. This is either 0 or 1. 


How many elements are in this set? The method S.size() returns the cardinal- 
ity! of s. 


Is aset empty? The method S.empty() returns a bool value: true when § is 
empty and false otherwise. 


Check if two sets are the same The operators == and != work as expected. The 
expression S==T returns true if S and T contain the same elements. 


Copy one set to another The statement S = T; overwrites S with a copy of T. 


There are other fundamental operations that one would like to perform on sets 
including finding the smallest (or largest) element in a set, printing all the elements 
in a set, and so on. The C++ set type can handle these tasks, but they are more 
complicated. Before we explain how to do these, we return to Pythagorean triples. 
We employ a strategy that is similar to the one we used in Program 7.2. We ask the 
user to input N. We then generate all pairs of integers (m,n) with 1 < m,n < VN. 
We use these to generate primitive Pythagorean triples. We examine each triple to 
see if c < N; if so, we add it to a set S. In the end, we print all the elements of the set. 
The difficult part of the program is printing the set! Here is the code; the explanation 
follows. 


'The container classes in the Standard Template Library have size() methods that report the number of 
elements held in the container. The value returned by size() method has type size_t which is often 
an unsigned value. Consequently, if you compare the return value from size() to, say, a long integer 
value, the compiler may issue a warning or an error. To fix this problem, you may need to convert the 
result of the size() method to a long value. Fortunately, this is simple. Replace X.size() with 
long(X.size() ) and all should be well. 
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Program 8.1: A program to find Pythagorean triples using sets. 


#include "PTriple.h" 
#include <set> 


int main() { 
set<PTriple> S; // Set to hold the PTriples we find 


// Ask the user for N 

cout << "Please enter N (upper bound on triples) --> "; 
long N; 

cin >> N; 

if (N <= 0) return 0; // Nothing to do when N isn’t positive 


// We only need to run the constructor arguments up to the square 
// rvoot of N. 
long rootN = long (sqrt(double(N)) ); 


// Run through possibilities and if appropriate, add to the set S. 
for (int k=1; k<=rootN; k++) { 
for (int j=l; j<=rootN; j++) { 
PTriple P(j,k); 
if (P.getC() <= N) 
S.insert(P); 


} 
} 
// Print out the elements of the set 
set<PTriple>::iterator si; // Iterator for S 
for (si = S.begin(); si != S.end() ; sit+t+) { 


cout << «si << endl; 


} 


return 0; 


We begin by declaring a set S (line 5) whose job is to hold the triples we find. 
Lines 8-11 ask the user for N and line 15 calculates | NJ. 


Lines 18—24 step through all values of m,n and use these to generate primitive 
Pythagorean triples. If the triple’s hypotenuse is no greater than N (line 21) then we 
add it to the set (line 22). 


The last part of the program (lines 27—30) prints the set S to the computer’s screen. 
To do this, we need an object called an iterator (explained next). 


At the end of the program, we do not need to delete the set S. The set is designed 
to release the memory it consumes when the procedure in which it was declared 
terminates. 
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8.2 Set iterators 


To access the 8th element of an array a is easy; we just type a[ 7]. (Remember 
that the first element of the array is a[0].) However, there is no method to access 
the 8th element of a set. When programmers built the C++ set class, they chose 
a design that would make the insertion, deletion, and element-query operations as 
efficient as possible. These requirements are incompatible with rapid access to the 
nth element for arbitrary n. 

Nonetheless, it is necessary for users to be able to access the elements held in a set. 
To do so, they can fetch the elements sequentially using an object called an iterator. 

A set iterator is an object that refers to elements of a set. The iterator specifies a 
“current” element of the set. There are three important operations set iterators can 
perform: 


(a) They can report the value at the “current” location, 
(b) They can advance to the next element in the set, and 
(c) They can step back to the previous element of the set. 


An iterator for a set is declared with a statement like this: 


set<long>::iterator si; 


This declares si to be an iterator for sets that contain long integers. The declaration 
does not give si any particular value; it is not ready to report on elements of a set. 

C++ set objects include a method named begin(). This method returns an 
iterator to the first (i.e., smallest) element of the set. So, if S is a set of long integers, 
we can initialize si with a statement like this: 


si = S.begin(); 


Note that si is not a long integer; it is an iterator. Hence a statement of the form 
cout << si does not print the smallest element of the set. To access the value that 
the iterator considers to be current, we use this syntax: «si. (The « operator is de- 
signed specifically to mimic the dereferencing notation used by pointers.) Therefore, 
the following code does what it says. 


set<long> S; 
set<long>::iterator si; 


if (!S.empty()) { 

si = S.begin(); 

cout << "The smallest element in S is " << xsi << endl; 
} 
else { 

cout << "The set S is empty" << endl; 


} 
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We push an iterator forward and backward using the increment ++ and decrement 
-- operators, respectively. That is, the statement si++ (or ++si) advances the iter- 
ator to the next element of a set and si-- (or --si) moves the operator back one 
step. 

We need to take care that we don’t run past the end of the set or rewind before 
its beginning. The set class provides the methods begin() and end() for this 
purpose. 

As we mentioned, S.begin() returns an iterator for the first element of a set, 
s. Unfortunately, S.end() does not return an iterator to the last element of the set! 
Instead, it returns an iterator one step past the end. (This design is consistent with 
the idea that if an array a contains n elements, then a[n] is one step past the end of 
the array.) If the set S is empty, S.begin() and S.end() give identical results. 

(In addition to begin and end, there is a pair of reverse iterators named rbegin 
and rend. Invoking S.rbegin( ) returns an iterator to the last element of the set and 
S.rend() returns an iterator to a position one step before the first element. These 
are useful if we want to step through the elements of a set from largest to smallest.) 

It is possible to compare iterators with the operators == and !=. 

With these ideas in place, here is how to print all the elements of a set to the 
computer’s screen. 


set<long> S; 
set<long>::iterator si; 


for (si = S.begin(); si != S.end(); sit+t+) { 


cout << «si << ; 


} 


cout << endl; 


This code prints the elements of S on a single line with spaces separating the ele- 
ments. 
Suppose we wish to sum the elements of S. Here is how we can do it. 
long sum = 0; 
for (si = S.begin(); si != S.end(); sit+t+) { 


sum += xsi; 


} 


You may not use set iterators to change a value in a set. The expression «si may 
not appear to the left of an = sign (assignment operator). 

Please refer to lines 27-30 of Program 8.1. There we declare an iterator si for 
sets of Pythagorean triples. We then use it to print (one per line) all the elements of 
the set s. 


Here is how to use iterators to create procedures to check if one set is a subset of 
another and to compute the union and intersection of sets.” 


?The code given here compiles and runs as expected when using the g++ compiler, but not with Microsoft 
Visual Studio. Here’s why and how to fix the problem. 
Explanation: Some iterators are capable of modifying the containers to which they refer (not set, but 
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bool subset(const set<long>& A, const set<long>& B) { 
if (A.empty()) return true; 
set<long>::iterator si; 
for (si=A.begin(); si!=A.end(); si+t+) { 
if (B.count(*si) == 0) return false; 
} 


return true; 


i 


void Union(const set<long>& A, const set<long>& B, set<long>& C) { 
C =A; 
set<long>::iterator si; 
for (si = B.begin(); si != B.end(); sit++) { 
C.insert(*si); 
} 
} 


void Intersection(const set<long>& A, const set<long>&B, set<long>& C){ 
C.clear(); 
set<long>::iterator si; 
for (si = A.begin(); si != A.end(); sit++) { 
if (B.count(*si)>0) { 
C.insert(«si); 
} 
} 
} 


The first procedure checks if A C B. The next two procedures set C equal to AUB 
and AM B, respectively. 

In all three procedures arguments A and B are declared const set<long>&. This 
means that A and B are sets of long integers and are passed by reference. Call by 
reference is important in this instance. The sets might contain tens of thousands of 
elements. If we used call by value (i.e., if we omitted the &), then the set would be 
copied and this takes time. By passing a reference, the procedure receives its data 
instantaneously. The const keyword is an assurance that the code that follows does 
not alter the sets A or B. 

Argument C in the second and third procedures holds the result of the computation. 
In order for the procedures to modify argument C it must be a reference variable 
(hence the & is required). 

The union and intersection procedures do not return a result; they are both type 
void. It might be tempting to declare the union procedure like this: 


others such as vector and list discussed later in this chapter). If an argument to a procedure is a 
container and declared to be a const reference, then using an iterator referring to that container could 
violate the const guarantee (because the iterator might modify the object). The g++ compiler allows 
us to use set iterators for const objects as there is no danger that the set can be modified through 
the use of the iterator. Visual Studio, however, takes a stricter approach. It does not allow us to use an 
iterator that refers to a const container. The solution is use a restricted form of an iterator called a 
const_iterator; we discuss these on pages 145-147. 

Solution: To make this code usable in the stricter context of Visual Studio, change all instances of 
iterator to const_iterator. 
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set<long> Union(const set<long>& A, const set<long>& B); 


Inside the procedure, we could build the union in a set named c and conclude with 
return C;. 

Such a procedure would work, but it would be inefficient. The problem is that the 
return variable would be copied to the calling procedure. 

We named the union procedure with a capital letter: Union. Why not name this 
simply union? The problem we are avoiding is that union is a C++ keyword (not 
one that is of interest to mathematicians). We cannot name a procedure union, just 
as we cannot name a procedure if or for. (See Section 15.5.3 if you are curious.) 

These procedures work perfectly for sets of long integers, but cannot be used 
for sets of double numbers. In C++ there is a mechanism to create a procedure 
schema (called a template) so that one procedure can be used with arguments of 
many different types. This is explained later (in Chapter 12). 


It is possible to initialize an iterator with methods other than begin and end. An- 
other useful method is find. If A is a set and e is an element, then A. find(e) re- 
turns an iterator for A that is focused on e. However, if e is notin A, then A. find(e) 
signals its inability to find e in the set by returning A.end( ), that is, an iterator that 
is one step beyond the end of the set. 


8.3 Multisets 


The directive #include <set> also provides the multiset type. A multiset 
may contain an element repeatedly. For a set, the count method returns only 0 
or 1; for multisets, it returns the multiplicity of the element, and this may be any 
nonnegative integer. 

A multiset iterator is declared in the expected way: 


multiset<type>::iterator mi; 


If an element appears several times in a set, «mi gives that value repeatedly as mi is 
increased. Here is an example. 


Program 8.2: A program to demonstrate the use of multiset. 


#include <iostream> 
#include <set> 
using namespace std; 


int main() { 
multiset<long> A; 


for (int k=1; k<=5; k++) A.insert(k); // A <- {1,2,3,4,5} 
A.insert(3); // we put an extra 3 into A 
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cout << "The size of A is " << A.size() << endl; 


// print the set 

multiset<long>::iterator ai; 

cout << "The elements of A are: "; 

for (ai = A.begin(); ai != A.end(); ait++) { 
COU <r cl <a 


} 
cout << endl; 
return 0; 


The output from this program is this: 


The size of A is 6 
The elements of A are: 123345 


8.4 Adjustable arrays via the vector class 


Arrays in C++ can be created in two ways. First, we can specify in our program 
how large the array should be: 


long primes[100]; 


Every time the program is run, the array primes has the same size. Alternatively, 
the array can be created while the program is running with a size that is determined 
at that time: 


long *primes; 
long n; 


primes = new long[n]; 
delete[] primes; 


Although this allows the size of an array to be set by the program while it is running, 
it does not provide all the functionality we might like. For example, if while the 
program is running we discover that the array is too small, there is no simple way 
to increase its size. Alternatively, once the array is populated with values, we may 
discover that we have overestimated its size. There is no simple way to shrink the 
array down to just the size we need (and thereby release the extra memory). Finally, 
dynamically allocated arrays should be released with a delete[ ] statement when 
they are no longer needed. However, it is easy to forget to do this. For example, a 
procedure might look like this: 


void procedure() { 
long xlist; 


list = new long[n]; 
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if (something _bad) { 
cout << "Trouble happens" << endl; 
return; 


} 


cout << "All’s well that ends well" << endl; 
delete[] list; 
} 


If something_bad evaluates to true the procedure ends early. In that case, the 
procedure never reaches the delete[ ] statement and the memory allocated to list 
is never released. We have a memory leak. When an array is passed to another 
procedure, the procedure that receives the array cannot determine the number of 
elements the array contains; that information would need to be passed as a separate 
argument. 


C++ provides a remedy to the many woes that plague ordinary arrays: “smart” 
arrays are called vectors. A vector holds elements of a given type in a list. The 
elements of the vector are accessed exactly as elements in an array. Before declaring 
any vector variables, the directive #include <vector> is required. Then, to 
create a vector of, say, long integers, we can use one of the following, 


vector<long> alpha; 
vector<long> beta(100); // round parentheses, not square brackets! 


The first creates a vector of longs of size zero and the latter creates a vector of 
longs that (initially) can hold 100 values. 

To learn the size of an array, use the size method: for example, beta.size() 
returns 100 (based on the declaration above). 

Because beta has size 100, its 100 elements can be accessed just as an array is: 
from beta[0] to beta[99]. It is an error to access beta[ 100] because that would 
be beyond the capacity of the vector. Unfortunately, this error may happen silently 
because vectors do not check if the index they are given is in the proper range.~ 

If the array we declared is not large enough, we can ask it to grow using the 
resize method. 
vector<long> beta(100); 
beta[99] = 23; 


beta.resize(110); 
beta[100] = -4; // OK; we have space up to beta[109] 


The amount of memory a vector uses is not always its size. Often, when a 
vector is resized, it grabs more memory than you requested. The resizing operation 
is time consuming if the vector does not have spare capacity. For example, suppose 


3The vector class provides a method named at() that may be used in place of the square brackets 
notation; that is, we can write vec.at(k) in place of vec[k]. The at() procedure checks that its 
argument is within range. If the index is illegal, then at() signals the error by throwing an exception; 
this is a concept discussed in Section 15.3. 
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the vector beta initially has size 100, and then (as in the example) you resize it to 
110 (.e., with the statement beta.resize(110);). Here is what happens behind 
the scenes. 


e The vector can only hold 100 elements and is out of space. So it requests a 
new block of memory of size 200 (even though you only asked for a resize to 
110). 


e The elements held in the old block of memory are copied to the new block of 
memory. 


e The old block of memory is released. 


At this point, the size of the vector is 110, but behind the scenes extra space has 
been grabbed for future expansion. If at this point you request beta. resize(120), 
no recopying of data is necessary. The vector simply grows into the memory it has 
already set aside. However, if you request beta.resize(250), the reallocation 
procedure happens again. 

You can inspect and control the amount of extra space a vector holds if you wish. 
The method capacity( ) returns the maximum size to which the vector can grow 
without going through the time-consuming reallocation process. A statement such 
as beta. reserve(1000) ; causes the vector to set aside room for 1000 elements. 
This statement does not affect the size of beta; it simply sets aside room for future 
expansion of the size. 

It is not necessary to use capacity and reserve. You may use the default be- 
havior and that should serve you well nearly all of the time. 

Invoking the clear() method on a vector erases all its elements and sets it size 
to zero. The method empty( ) returns true in case the size of the vector is zero. 

One more method: invoking beta.max_size() returns the maximum possible 
capacity a vector may have on your computer. (On my computer, the result is just 
over one billion.) 


A special type of vector is one that holds bool values. If we declare a Boolean 
array, such as bool flags[1024]; the array holds each true/false value in at least 
one byte (or worse). This is an inefficient use of the computer’s memory. Instead, 
we can declare flags like this: 


vector<bool> flags(1024); 


With this, we can access individual elements exactly as if flags were an array (type 
bool) but the memory use is much more efficient. Each byte of memory can hold 
eight bits. This is not significant when dealing with only an array whose size is in the 
thousands, but it becomes an issue when the array has millions or billions of entries. 
On the other hand, accessing individual entries in a vector<bool> is slower than 
accessing elements of an array. The vector<boo1l> needs to do extra work to access 
individual bits held in its memory. 
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To illustrate the use of vector objects, let us revisit the Sieve of Eratosthenes. We 
use a vector<long> to hold the table of primes. The sieving part of the procedure 
uses a vector<bool1>. 

The header file vector-sieve.h declares the new version like this: 


long sieve(long n, vector<long>& primes); 


The first argument gives an upper bound on the primes to be generated. The second 
is a place to hold the primes. In this instance, we do not need to worry if the object 
primes is large enough to hold the values. It is resized as needed as the algorithm 
runs. The return value is the number of primes found. Here is the code. 


Program 8.3: The Sieve of Eratosthenes revisiting using vector classes. 


#include "vector-sieve.h" 


long sieve(long n, vector<long>& primes) { 
primes.clear(); // erase the sieve 


if (n < 2) return 0; // no primes < 2 


// Make a table of boolean values. true = prime and false = 
// composite. We initialize the table to all true. 
vector<bool> theSieve; 

theSieve.resize(n+1); 

for (long k=2; k<=n; k++) theSieve[k] = true; 


long idx = 0; 
for (long k=2; k<=n; k++) { 
if (theSieve[k]) { 
primes.resize(idx+1); 


primes[idx] = k; 
adxt+; 
for (long d = 2«k ; d<=n; dt=k) theSieve[d] = false; 
} 
} 
return primes.size(); 


We know that the sieve table, theSieve, needs to run up to theSieve[n] so 
we immediately resize it to hold n+1 values (line 11). The rest of the program does 
the usual sieving procedure. Each time we add an element to the table (when the 
condition on line 16 is satisfied), we increase the size of primes by one and insert 
the newly found prime into the last position.t Occasionally, the computer needs 
to reserve larger and larger chunks of memory to hold the growing vector. In 
this program, we trust the default behavior. However, we could have monitored 
the capacity of the vector and increased it (say, by 100,000 cells) each time it was 
exhausted. 


“There is an alternative way to add one element to the end of a vector: use the push_back method. 
That is, if vec is a vector, then vec. push_back(x) increases the size of vec by one and puts a 
copy of x into the newly created last position. 
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Here is a main to illustrate the use of the new sieve procedure. 


#include "vector-sieve.h" 
#include <iostream> 
using namespace std; 
/// Test the vector version of sieve. 
int main() { 
vector<long> primes; 
long N; 
cout << "Find primes up to what value? "; 
cin >> N; 


// Generate the primes 

sieve(N, primes); 

cout << "We generated " << primes.size() << " primes" << endl; 

cout << "The largest of which is " << primes[primes.size()-1] 
<< endl; 

return 0; 


Running this program with N equal to one billion gives the following in a matter 
of minutes. 


Find primes up to what value? 1000000000 
We generated 50847534 primes 


The largest of which is 999999937 





This would not have been possible on my computer using the old version of sieve 
because the sieve table would have exhausted all available memory; the space effi- 
ciency of vector<bool> made this possible. 


8.5 Ordered pairs 


Ordered pairs occur frequently in mathematics and C++ has a convenient mech- 
anism for handling them. The two entries in an ordered pair need not be the same 
type. To use the C++ type pair, you first need the directive #include <utility>. 
Then, the following declaration creates an ordered pair named couple whose first 
entry is a long integer and whose second entry is a double real number: 


pair<long, double> couple; 


The C++ pair does not hide its data in a private section, so it is easy to extract 
and modify the entries. The two data members are named first and second. To 
set the pair couple we defined above to (6,7), we use these statements: 


couple.first = 6; 
couple.second = M PI; 
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Ordered pairs are convenient for procedures that return two values. Rather than 
modify call-by-reference arguments (as we did in the extended gcd procedure), a 
procedure can return a pair containing the two quantities of interest. 

For example, here is a procedure to simulate the roll of a pair of dice. It returns an 
ordered pair of random integers (x,y) with 1 <x,y <6. 


#include <utility> 
#include "uniform.h" 
using namespace std; 


pair<long, long> dice() { 
long a = unif(6); 
long b = unif(6); 
return make_pair(a,b); 


The return statement uses the make_pair procedure; make_pair is a convenient 
mechanism for the creation of ordered pairs. The two arguments to make_pair can 
be any C++ type; the compiler knows the types of the arguments and creates a pair 
in which first and second have the correct type. 

Ordered pairs can be compared for equality using the == and != operators. If < is 
defined for the two types held in the pair, then < can be used to compare the pairs; 
the comparison is lexicographic comparing first first and then second. 


8.6 Maps 


A C++ vector can be thought of as a function defined on the finite domain 
{0,1,2,...,2—1}. The values this function takes may be any C++ type. 

C++ provides a generalization of vector called map. A map behaves much as 
does a (mathematical) function f : A — B where A is a finite set. Recall that a 
mathematical function is a set f of ordered pairs (a,b) with the property that if 
(a,b), (a,c) € f, then b =c. Similarly, a C++ map is a container that holds key/value 
pairs (k,v) with the property that for each key k there can be at most one pair (k,v) 
held in the map. 

A map object is declared like this: 


#include <map> 


map<key type, value_type> m; 


The #include <map> directive is necessary to define the map type. The types 
key_type and value_type can be any C++ types as long as key_type can be 
ordered using <. For example, we can declare a map as map<long,double> f; 
and then £ acts as a function from a finite subset of Z to R. 
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Once declared, there are natural operations we can perform with maps. In the 
examples that follow, £ is a map declared as map<long, double>. The variable k is 
a key (hence of type long) and the variable v is a value (hence of type double). 


Set f(k) = v for a given key & and value v To insert the key-value pair (k,v) into a 
map f, the simplest thing to do is to use the following statement, 


f[k] =v; 


Alternatively, one can use the insert method to add the pair (k,v) to f. The 
statement looks like this: £.insert(make_pair(k,v) );. Clearly, the syn- 
tax £[k]=v; is simpler and clearer. 


Note that if a function value is already defined for f(k), then the statement 
£[k]=v; overwrites the old value for f(x). 


Determine if f() is defined for a given k For this we use the count method. The 
expression f.count(k) returns the number of key/value pairs in £ that con- 
tain the key k; this is either 0 (£[k] is undefined) or | (£[k] is defined). 


Determine the value v associated with a key k In other words, given k, find f(k). 
The easy way to do this is to use £[k]. Provided £[k] is defined, this returns 
the value associated with the key k. Thus £[k] may appear on either the left 
or right side of an assignment statement, or in any expression we like. 


This leads to the question, what happens when we have a statement such as 
cout << £[5] << endl; but we have not yet defined £[5]? First, you 
should be careful in writing your programs so that this situation does not arise. 
What happens is that seeing that a value for £[5] is needed, the computer 
assigns a value to £[5]. This value is some sort of default value provided by 
the value’s type. In this example, because the values are of type double, a 
tacit £[5] = 0.; takes place. 


It is risky to rely on default behaviors and much better to be careful in your 
programming so that you check if £[5] is defined (with a statement such as 
if(£.count(5)>0){...}). 


Undefine f(k) Given a key k, we might wish to reset £[k] to undefined by erasing 
the key-value pair with key k. The erase method does this: f.erase(5) ; 
deletes (5,v) is there is such a pair in £. 


Determine the number of key-value pairs ina map The size method does just 
this task. The expression £.size() returns the number of key-value pairs 
held in £. 


Reset a map to its empty state The statement £.clear(); clears the map. This 
results in £.size() evaluating to zero. 


Check if a map is empty The statement f.empty() yields true if f.size() is 
zero, and false otherwise. 
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If we wish to examine, one by one, all the pairs held in a map we need to use a 
map iterator. The method for doing this is similar to the one we examine for sets. 
The declaration for a map iterator looks like this: 


map<key type,value_type>::iterator mi; 


At this point, the map iterator mi is declared, but does not refer to any part of any 
map. The map class provides the methods begin and end that are analogous to the 
same-named methods for set. The expression f.begin() returns an iterator that 
refers to the first ordered pair held in £ (assuming f is not empty). The expression 
f£.end() gives an iterator that is positioned one place past the end of the map. 

The variable mi is not an element of the map f, but rather is a device for extracting 
the members of the map. Because a map is a collection of ordered pairs, the expres- 
sion «mi returns an object of type pair<key_type,value_type>. Let’s see how 
this works with an example. 


Program 8.4: A program to illustrate the use of maps. 


#include <iostream> 
#include <map> 
using namespace std; 


lx 
x A program to illustrate the use of maps. 
aif 


int main() { 
map<long, double> f; // £ is a function from integers to reals 


f£[-3] = 0.5; 


£[2] = MPI; 

£[6] = 11; 

£[0] = -1.2; 

£[6] = exp(1.); // notice we are overwriting f[6] 


for (long k=0; k<10; k++) { 
COutm<< su Them vcllhWen Ot nt |<< ke — |e Sinus 
HCE (tre OITA (KS) ea) ett 
cout << £[k] << endl; 
} 
else { 
cout << "undefined" << endl; 
} 
} 


cout << "There are " << f.size() << " ordered pairs held in £” 
<< endl << "They are: "; 


map<long,double>::iterator mi; 

for (mi = f.begin(); mi != f.end(); mit++) { 
long k = («mi).first; 
double v = (*mi).second; 
come << "(" ee ik eet” ee y ee 7) Ms 


} 
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cout << endl; 


return 0; 


} 


The map f is declared on line 10. Lines 12—16 set various values for £[k]. Note 
that we define £[6] on line 14, but then it is overwritten (with value e) on line 16. 

Line 18 steps through key values from 0 to 9. If the function is defined for that key, 
we print out the corresponding value; otherwise, we announce that it is undefined. 

Line 31 declares a map iterator mi that we use in lines 32—37 to print out all 
the ordered pairs held in the map. As mi steps through the map, we extract the 
data to which it refers. Remember that »«mi is a pair, and so to access its two 
entries, we use first and second. The expression (*mi).first gives the key 
and (*mi) second gives the corresponding value.> 

The output of this program follows. 


The value of f[0] is -1.2 

The value of f[1] is undefined 
The value of f[2] is 3.14159 
The value of £[3] is undefined 
The value of £[4] is undefined 
The value of £[5] is undefined 


The value of f£[6] is 2.71828 

The value of f£[7] is undefined 

The value of £[8] is undefined 

The value of £[9] is undefined 

There are 4 ordered pairs held in f 

They are: (-3,0.5) (0,-1.2) (2,3.14159) (6,2.71828) 





An interesting use for maps is the implementation of look-up tables. Suppose we 
want to create a procedure for a function f and calculating f(x) is time consuming. 
It would be useful if the procedure could remember past values that it calculated. 
That way, we would never have to calculate f(x) twice for the same value of x. 

For example, consider the following recursively defined sequence of numbers ay, 
forn € Z*. Let aj = 1. Forn > 1, let 


an = aq. 
d|n,d<n 


For example, 
a2 =a, +a9+a3+a4+a =14+14+14+24+3=8. 


If we program a procedure to calculate a, recursively, then the computation of aj2 
requests the values a1, a2, a3, a4, and ag. Except for a; (the base case) each of these 
spawns additional calls to the procedure. To prevent this inefficiency, we program 
the procedure to remember the values it already calculated. 


5There is an alternative to the notation (*mi).f£irst. Instead, we can write mi->first. The C++ 
expression a—>b is defined to mean (*a) .b. 
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To do this, we include a map as a static variable in the procedure. A static variable 
retains its state even after the procedure exits. Here is the code for the procedure that 
we call recur. 


Program 8.5: A procedure that remembers values it has already calculated. 


#include "recur.h" 
#include <map> 
using namespace std; 


long recur(long n) { 
static map<long, long> lookup; 


if (n <= 0) return 0; 
if (n == 1) return 1; 


if (lookup.count(n) > 0) return lookup[n]; 


long ans = 0; 
for (long k=1; k<=n/2; k++) { 
if (n%k == 0) ans += recur(k); 


} 
lookup[n] = ans; 


return ans; 


The look-up table is declared on line 7. It is a map in which keys and values 
are both of type long. It is declared static so that its state is preserved between 
procedure calls. 

Lines 8 and 9 handle the base cases. If the user gives an illegal (i.e., nonpositive) 
value for n, we return 0. For the case n = 1, we return a; = 1. 

Next (line 12) we check if we have already calculated a, for this value of n; if so, 
we simply return the value we previously computed. 

Otherwise (we have not previously computed a,) we calculate a, by summing ag 
over proper divisors of n (lines 15-17). (Please note that this is done in a rather 
inefficient manner; we sacrificed efficiency here for the sake of pedagogic clarity.) 

Finally, before returning the answer (held in ans) we record the value for a, in the 
look-up table (line 19). 

This procedure is more than twice as fast as a conventional recursive procedure. 
There is, however, a price to be paid. As more and more a, values are calculated, 
they occupy memory. This is a classic time/memory tradeoff. One flaw with this 
code is that there is no way to clear the memory consumed by the look-up table. 
We could design the code so that if the user sends a negative value to the procedure, 
then the memory is released. That is, we could add the following statements to the 
program. 


if (n<0) { 
lookup.clear(); 
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return 0; 


} 


Just as the set type can be extended to the multiset type, there is also a class 
named multimap that allows multiple values to be associated with a given key. 


8.7 Lists, stacks, and assorted queues 


There are additional object container classes available in C++ and we discuss some 
of them here. Each has its strengths and weaknesses. We give a brief overview of 
each and then delve into a few details. All of these containers support the following 
operations. 


Erase all elements The statement C.clear( ); erases all the elements in the con- 
tainer C. 


Determine the size of the container Use C.size(). 
Check if the container is empty Use c.empty(). 


Make a copy of the container Use new_c = C;. 


8.7.1 Lists 


A list is acontainer that holds values in a linear structure. One can rapidly insert 
new elements at the beginning, end, or anywhere in the middle of a list. Deletion of 
elements at any point in the list is also efficient. However, to access, say, the 17th 
element of a list, one has to go to the beginning of the list and step forward repeatedly 
until we arrive at the desired element. There is no way to check if a given element is 
in the list except by stepping through the list element by element. 

To use a list in your program, start with the directive #include <list>. To 
declare a variable to be a list of elements of type, say, long, use a statement such 
as list<long> L;. 

Elements of a list can be accessed through iterators. To declare an iterator for a 
list, use a statement such as this: 


list<long>::iterator Li; 
If L is a list, L.begin() is an iterator for the first element of the list (assuming the 


list is not empty) and L.end( ) is an iterator that is one step past the end of the list. 
Here are some common tasks that one can perform on a list. 


Insertion To insert an element e at the start of a list L, use L.push_front(e). 
Now eis the first value on the list and all the previously held values follow. To 
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insert at the end of the list, use L. push_back(e) ; and now eis the last value 
held. 


More generally, if Li is an iterator into a list L, then L.insert(Li,e) in- 
serts e into the list in front of the element pointed to by Li. For example, 
if the list is (1,3,5,6,5,—7,2) and Li points at the —7, then the statement 
L.insert(Li,17); modifies the list so it now holds (1,3,5,6,5,17,—7,2). 
The statements L.push_front(e); and L.insert(L.begin(),e); are 
equivalent. Similarly, L.push_back(e); andL.insert(L.end(),e); are 
equivalent. 


Deletion To delete the first element of a list, use L.pop front(); and to delete 
the last element of the list use L. pop_back() ;. 


To delete an element referred to by an iterator Li, use L.erase(Li) ;. 
To delete all elements equal to e, use L. remove(e) ;. 


It is also possible to remove all elements that satisfy a given condition. To 
do this, create a procedure that returns a bool value. For example, here is a 
procedure that checks if an integer is even. 

bool is_even(long n) { 


return (n%2 == 0); 


} 


Now, to remove all even elements from a list of long integers, use the state- 
ment L.remove_if(is_even);. 


Sorting If the list holds elements for which < is defined, the statement L.sort() ; 
sorts the list into ascending order. 


Once a list is sorted, the statement L. unique( ) ; removes duplicate values. 


Modification of a value To change a value held in a list, you need an iterator Li 
focused on its spot in the list. Then you simply assign to »Li. For example, 
here is some code that changes the value held at the second position in a list 
(assuming the list has at least two elements). 


list<long> L; 


list<long>::iterator Li; 

Li = L.begin(); 

Lit++; // now refers to 2nd element of list 
xLi = -51; 


Here is a sample program to illustrate these ideas. There are two new ideas in this 
program. First, we included all the procedures in one file. Each procedure is defined 
fully before it is used; therefore the main( ) procedure comes last. In general it is 
better to put procedures into separate files and their declarations into a header (.h) 
file; it is just easier to present these all as one file for pedagogic purposes. 

Second, we introduce a variation on the iterator concept: a const_iterator. 
We explain that after we present the program. 
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Program 8.6: A program to demonstrate the use of lists. 


#include <iostream> 
#include <list> 
using namespace std; 


/// BR procedure to print a list to cout 
void print _list(const list<long>& L) { 
list<long>::const_iterator Li; 
for (Li = L.begin(); Li != L.end(); Lit++) { 
SO Uitte 1 


} 


cout << endl; 


} 


/// Check if an integer is even (to illustrate remove_if) 
bool is_even(long n) { 
return (n%2 == 0); 


} 


/// A main to illustrate various list operations 
int main() { 

list<long> L; 

L.insert(L.begin(),4); 

L.insert(L.end(),15); 

L.insert(L.begin(),7); 

L.push_front(24); 

L.push_back(5); 

L.push_front(99); 


list<long>::iterator Li; 

Li = L.begin(); 

Lit++; // Focus on 2nd element in the list 
L.insert(Li,0); // Inserts in front of 2nd element 

cout << "Here is the list: "; 

print_list(L); 

cout << "The first element of the list is: " << L.front() << endl; 
cout << "The last element of the list is: " << L.back() << endl; 
cout << "The list contains " << L.size() << " elements" << endl; 


Aires Ota) Re 
cout << "And now sorted: ee 
print_list(L); 


L.pop_back(); 
L.pop_front(); 
cout << "First and last deleted: "; 
print_list(L); 


L.remove_if(is_even); 

cout << "Even values deleted: "; 
print_list(L); 

return 0; 
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The first procedure in this program is used to print a list to the computer’s screen. 
We pass the list as a reference variable because this is more efficient (hence the & on 
line 6). Had we passed the list by value, a new copy of the list would have been 
created and that’s a waste of time and memory. 

Because this procedure does not modify the list, we certify that with the keyword 
const on line 6. 

The next step is to declare an iterator for the list and use that to report each value 
held in the list. Here’s the problem. An iterator can be used to modify list values. 
If the C++ compiler sees you working with an iterator for the argument L it worries 
that you might change the elements held in the list. Suppose we had declared Li in 
the usual way: 


list<long>::iterator Li; 


If we then focus Li on an element of L (e.g., with Li = L.begin();) then the 
compiler gets upset because we now have the ability to modify L. 

So, instead of using a “full power” iterator, we instead declare Li to be a “read 
only” iterator—an iterator that can learn the values held in the list, but cannot modify 
them. Such an iterator is known as a const_iterator and it is declared like this 
(see also line 7): 


list<long>::const_iterator Li; 


Now the compiler can stop worrying that we might modify L in this procedure. The 
rest of the print_list procedure is straightforward. 

(Aside: We could have defined an operator<< to send lists to the computer’s 
screen. Then we could write statements like this: cout << L;.) 


The is_even procedure on lines 15-17 is used to illustrate remove_if later in 
the program (line 50). 


The main procedure appears on line 20 and begins by declaring L to be a list of 
integers. We first insert 4 at the beginning of the list, then 15 at the end, and then 7 
at the beginning. The list now stands at (7,4, 15). 

Next we insert 24 at the beginning, 5 at the end, and 99 at the beginning. Now the 
list is (99,24,7,4, 15,5). 

On lines 30-31 we focus Li on the second element of the list (which holds the 
value 24). The statement L.insert(Li, 0); inserts the value 0 in front of 24; now 
the list holds (99,0,24,7,4, 15,5). 

Lines 34—38 are self-explanatory. 

Line 40 sorts the list; it now holds (0,4,5,7, 15,24,99). 

On lines 44-45 we delete the first and last elements of the list. Now the list holds 
(4,5,7, 15,24). 

On line 49 we delete all elements that evaluate to true when processed by the 
is_even procedure. This reduces the list to (5,7, 15). 

Here is the output from the program. 
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Here is the list: 99 0 24 74155 
The first element of the list is: 99 
The last element of the list is: 5 
The list contains 7 elements 


And now sorted: 045 715 24 99 
First and last deleted: 4 5 7 15 24 
Even values deleted: 5 7 15 





8.7.2 Stacks 


A stack is a container that holds elements in a linear structure. New elements 
can be added only at one end of the stack (called the top of the stack). The only 
element that can be deleted is the one at the top of the stack, and it is also the only 
one that is visible. 

Before declaring a stack variable, use the directive #include <stack>. Now to 
declare a stack of, say, double values, use a declaration like this: 


stack<double> S; 
There are four methods you need to know to work with stacks. 


Check if the stack is empty The empty() method returns true if the stack con- 
tains no elements. 


Add an element to the top of a stack Use the push method: S.push(x);. 


Learn the value held at the top of the stack Use S.top(). You may also use the 
top method to modify the topmost value, as in S.top()=M_PI;. 


Remove the top value held in the stack The statement S.pop() ; removes the top 
element from the stack. 


8.7.3 Queues 


A queue is a container that holds elements in a linear structure. New elements are 
added only at one end of the queue (called the back). The only element that can be 
removed from the queue (and the only one whose value is visible) is at the opposite 
end of the queue (called the front). 

To use queues in your program, use the directive #include <queue>. Declare 
your queue like this: 


queue<long> Q; 


Here is what you need to know to use queues. 


To check if the queue is empty Q.empty() returns true if the queue is empty and 
false otherwise. 


To add an element to the back of the queue Q.push(e) inserts the value in e to 
the end of the queue. 
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To see the value at the front of the queue Q.front() gives the value held at the 
head of the queue. 


To delete the value at the front of the queue Use the statement Q.pop() ;. 


It is also possible to look (and modify) the last element in the queue with the 
back() method, but this is not in the spirit of queues. The usual mode of operation 
with queues is to insert values at the back of the queue and not deal with them again 
until they emerge at the front. 


8.7.4 Deques 


A deque is a double-ended queue (hence its name). It is a container that holds 
elements in a linear structure. New elements can be inserted or deleted at either end. 
It is possible to access (and modify) any element of a deque quickly using array 
notation (e.g., D[4]). These containers incorporate features of stacks, queues, and 
vectors. 

To use a deque in your program, use the directive #include <deque> and de- 
clare your variables like this: 


deque<long> D; 


Here are the most important things you can do with a deque. 


Add elements To add a value to the back use D. push_back(e) ; and to add a value 
to the front use D. push_front(e);. The “front” of the deque is considered 
its beginning and the “back” is its end. 


Delete elements The methods pop _front() and pop_back() delete the first and 
last elements of the deque, respectively. 


Inspecting and modifying elements The methods front () and back() can be 
used to get the first/last values in the deque, and to modify those values. A 
statement such as D. front ()=34; changes the first element’s value to 34. Of 
course, these methods require that the deque be nonempty. 


Alternatively, one can use square brackets to get or to modify any value held in 
a deque. Index 0 always refers to the first (front) element of the deque. Index 
D.size()-1 is used for the last. To change the second entry in a deque, one 
would use a statement like this: D[1]=86;. As with arrays and vectors, it is 
important not to give an out-of-range index. 


Deques support iterators (declared like this: deque<long>::iterator Di;), 
but it is easier to use square brackets to work with individual entries. 
Here is a short program to illustrate the use of deques; its output follows. 
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Program 8.7: A program to illustrate the deque container. 


#include <iostream> 
#include <deque> 
using namespace std; 


int main() { 
deque<long> D; 


D.push_back(17); 
D.push_back(23); 
D.push_front(-9); 
D.push_ front(5); 


Diy) = Op 


cout << "The first element of the deque is " << D.front() << endl; 
cout << "The last element of the deque is " << D.back() << endl; 
cout << "Here is the entire structure: " ; 
for (long k=0; k<D.size(); k++) { 

COuta<<—sD [)ki|<<—eues 
} 


cout << endl; 


return 0; 


The first element of the deque is 5 
The last element of the deque is 23 


Here is the entire structure: 5 0 17 23 





8.7.5 Priority queues 


A priority queue is a container that holds its elements in a treelike structure. 
The elements must be comparable via the < operation. Elements can be inserted at 
any time but only the largest is visible and deletable. 

To use apriority queue include the <queue> header and declare your variable 
like this: 


priority queue<long> PQ; 


The relevant operations for a priority queue are these. 


Adding a value Use PQ.push(e) ;. 
Getting the largest value held Use PQ.top(). 


Deleting the largest value held Use PQ. pop() ;. 


A short program to illustrate these concepts, and its output, follow. 
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Program 8.8: Demonstrating the use of the priority_queue container. 


#include <iostream> 
#include <queue> 
using namespace std; 


int main() { 
priority queue<long> PQ; 


PQ.push(5); 
PQ. push(12)-; 
PQ. push (0); 
PQ.push(-7); 


cout << "The elements we pushed into the priority queue are "; 
while (!PQ.empty()) { 
COUEE <<a DO i2 0) () it <<a) 
PQ.pop(); 
} 
cout << endl; 
return 0; 


The elements we pushed into the priority queue are 12 5 0 -7 


8.8 Exercises 


8.1 In mathematics, the elements of a set can themselves be sets. Show how to 
declare a set of sets of integers in C++ and write a short program that creates 


the set {{1,2,3}, {4,5}. {6} }. 


8.2 Write a procedure to print a set of long integers to the screen. The elements 
of the set should be enclosed between curly braces and separated by commas. 
(Be sure that the last element of the set is not followed by a comma.) The 
output should resemble these examples: 


{1,2,3} {-1} {0,1} {} 


8.3 Suppose we wish to use sets of complex numbers in a program. As a test, we 
create this simple program: 


#include <complex> 
#include <set> 
using namespace std; 


int main() { 
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complex<double> z(2.,3.); 
set< complex<double> > A; 
A.insert(z); 

return 0; 


} 


This program creates a complex number z = 2 + 3i and a set of complex num- 
bers A into which we insert z. Unfortunately, the computer fails to compile 
this code and, instead, prints out a long stream of error messages that includes 
a complaint that there is 

no match for const std::complex<double>& < 


const std::complex<double>&’ operator 


What is wrong and how can we fix this? 


Let a1 ,a2,a3,... be the sequence of numbers defined recursively by 


a,=1 and a= S aq. 
d|n,d<n 
These are the values calculated by Program 8.5 (page 143). 


Prove that a, is the number of ordered factorizations of n. That is, the number 
of ways to write n = f\ f2---f; where the f; are integers with f; > 1. For 
example, ag = 3 because the ordered factorizations of 6 are 


6 2*3 3x2. 


We have a; = | because the empty product evaluates to 1. 
Find another combinatorial description of this sequence. 
Create a class to represent integer partitions. Given a nonnegative integer n, a 


partition of nis a multiset of positive integers whose sum is 7; the elements of 
the multiset are called the parts of the partition. 


Name your class Partition and give it the following capabilities: 


e A constructor that creates the empty partition of 0. 
e An add_part method for adding a part. 


e A get_sum method for learning the sum of the parts in the partition (i.e., 
the number partitioned by this Partition). 


e An nparts method that reports the number of parts in the partition. 


e A get_parts that returns the parts of the partition in a vector<int> 
container. 


e An operator< to give a total order on the set of integer partitions. 


e An operator<< for writing Partition objects to the screen. Choose 
an attractive output format. For example, the partition {1,1,3,4} of 9 
can be written to the screen as 9 = 4+3+1+1. 


8.6 


8.7 


8.8 
8.9 


8.10 


8.11 


8.12 
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Use the Partition class that you developed in Exercise 8.5 to create a pro- 
gram that prints out all the partitions of a positive integer n, where n is specified 
by the user. 


Create a procedure to calculate binomial coefficients ie) by the following algo- 
rithm. When k = 0 or k = a, set ee) = |. Otherwise, use the Pascal’s triangle 


identity: (7) = (1-1) +(";'). This can be done recursively, but if the re- 
cursion is done naively, the same binomial coefficients are recalculated many 
times. Instead, devise a procedure that never calculates any binomial coeffi- 


cient more than once. 
Write a procedure to convert an array of long integers into a vector<long>. 


Sorting vectors. Suppose values is a vector<long> of size 10 and we wish 
to sort the elements held in values into ascending order. We might consider 
the statement sort(values, values+10); but that is incorrect (and the 
compiler generates an error message). 


Next we guess that (like a list) vector defines a sort method. So we try 
values.sort(); but this is also incorrect. 


The difficulty with the first approach is that values is an object of type 
vector<long> and, unlike a C++ array, is not a pointer to the first element. 
So the expression values+10 is illegal. The difficulty with the second ap- 
proach is that vector objects do not define a sort method. 


How do we sort elements held in a vector? 
Hint: In place of pointers to the first and one-past-the-last elements usually 


required by sort, we can use iterators. 


Suppose we have an iterator that refers to an element of a set, and then we 
delete that element from the set. What can you say about the iterator now? 


In light of Exercise 8.10, write a procedure that deletes all odd elements from 
a set of integers. Such a procedure would be declared such as this: 


void delete _odds(set<long>& A); 


In many instances we want to perform an action on all the elements of a con- 
tainer. To do this, we typically use an iterator like this: 


set<long> A; 


set<long>::iterator sp; 

for (sp = A.begin(); sp != A.end(); ++sp) { 
// do something with the value «sp 

} 


Because this structure is so frequent, the Standard Template Library provides 
a procedure named for_each that acts just as the code above does. The 
for_each procedure is defined in the algorithm header. 
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A call to for_each looks like this: 


for_each(cont.begin(), cont.end(), proc); 


Here cont is a container (such as a set or vector) and proc is a proce- 
dure that takes a single argument of the same type as cont houses. Fur- 
thermore, proc does not have a return value. For example, if cont is a 
vector<double>, then proc would be declared void proc(double x);. 


The statement for_each(cont.begin(),cont.end(),proc) ; is equiva- 
lent to this code: 
vector<double>::iterator vi; 
for (vi=cont.begin(); vil=cont.end(); ++vi) { 
proc(«vi); 


} 


Use the for_each procedure to create a print_set procedure that prints out 
a set of long integers to cout. The format of the output should look like this: 
{139}. 


A simplicial complex can be defined combinatorially as a finite set .Y of finite 
nonempty sets with the property that if Ac Y and@ AB CA, then BEY. 
The sets in .Y are called the simplices of the simplicial complex. 


For example, this topological simplicial complex 


2 4 


can be written combinatorially as 
{{1},{2},{3}, {4}, {5}. {1,2}. {1,3}, {2,3}, {2,4}, {3,4}, {3,5}, {2,3,4}}. 


Create a class called SimplicialCompl1lex that holds such structures. For the 
sake of efficiency, store only the maximal simplices in the complex. For the 
example given above, the maximal simplices are {1,2}, {1,3}, {2,3,4}, and 
{3,5}. 

The class should contain a basic constructor (that creates an empty simplicial 
complex) and a method to add new simplices. The add method should be 
careful to deal with the following two situations. 


e If the new simplex X is already in the simplicial complex do not add it 
again; we need to check that X is not a subset of one of the maximal 
simplices in 7. 
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e If the new simplex X is not in .”, but contains some of the simplices 
already in .7, then we need to update the set of maximal simplices to 
include X and to delete those that are proper subsets of X. 


The class should also contain a method to check if a given simplex X is a 
member of the complex. 


If you are feeling adventurous, create an erase method to remove simplices 
from the complex. Of course, when a simplex X is deleted from .7, we must 
also delete all simplices that contain X. We then need to be careful to update 
our collection of maximal simplices. If we delete the simplex {3,4} from the 
example in the figure, then we must also delete {2,3,4}. After the deletion, 
the simplex {2,3} is maximal. 


Chapter 9 





Modular Arithmetic 


Let n be a positive integer. The set Z,, is {0,1,...,1—1}. The set Z,, is a ring with 
the following operations. 


x+y= (x+y) mod n and x-y = (xy) mod n 


The goal for this chapter is to develop a C++ class for working in Z,. Most of 
the C++ techniques used in this chapter have already been developed in previous 
chapters, but a few new ideas are presented here as well. The creation of a C++ class 
for representing elements of Z,, is necessary for our later work in general finite fields. 





9.1 Designing the Mod type 


In order to design a C++ class to emulate Z,, we need to decide what sort of data is 
stored in each object as well as the methods and operations to be performed on these 
objects. We also need a name for the new class and we choose the name Mod. 

Each object of type Mod represents an element of Z,, for some positive integer n. 
The element 8 in Zo is different from the element 8 in Z,,. (Consider the result of 
the operation 8 + 8.) Thus, each Mod object needs to hold two integers: the value in 
Zn and the modulus, n. We call these val and mod and we declare these as private 
members of the Mod class. To represent 8 in Z1;, we set val equal to 8 and mod 
equal to 11. 

We need a constructor to create Mod objects, and the natural choice is to have a 
constructor with two arguments: one that specifies the value and one that specifies 
the modulus. However, all classes should provide a default constructor that takes no 
arguments. What sort of object should Mod() construct? A natural choice is to set 
val to zero, but what of the modulus? One idea is to choose a default modulus that 
is used when a user does not specify a modulus. We are then faced with a decision: 
What should that default modulus be? Rather than impose a solution, we let the user 
decide. So we need a mechanism to set the default modulus. The implementation of 
this leads us to some new C++ concepts (static class variables and methods) and we 
explain these later in this chapter. 

Now that we have the concept of a default modulus we may also create a single- 
argument constructor. A call to Mod (x) should create a new Mod object with value 
x in the default modulus. 
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So far, the Mod class looks like this: 


class Mod { 
private: 
long val; 
long mod; 
public: 
Mod (); 
Mod(long x); 
Mod(long x, long m); 
}; 


The operations and methods we want to perform with Mod objects are these. 


e Given a Mod object, we need to inspect and to modify both its value and its 
modulus. Changing either the value or the modulus may require us to change 
the other because a value x € Z,, must satisfyO <x <n—-1. 


e Given two Mod objects, we should be able to check whether they are equal. 
In addition, we define a < operator to compare Mod objects; this enables us to 
store Mod objects in containers such as a set that require a < operator. 


e We want to be able to perform the usual arithmetic operations: 


x+y; X-y; X*y; X/y; 
x += yp X —= yy X *= ye X /= Yi 
es 


For these operations, we need to be concerned about two situations that may 
arise: combining objects of different moduli and division by a noninvertible 
element of Z,. We handle these by returning an invalid Mod object. This 
invalid value is represented internally with value and modulus equal to zero. 
(Valid Mod objects have a positive modulus.) 


Furthermore, it is convenient to be able to combine Mod and long objects 
with a single operation. For example, suppose x and y are Mod objects, then 
a statement such as y = x+1; should assign to y a value one greater than x’s 
and the same modulus as x. 


e In addition to the operations listed above, we want to perform exponentiation 
a‘ where a € Z, and k € Z. Negative exponentiation gives a valid result pro- 
vided a is invertible. 





9.2 Thecode 


We now present the Mod.h and Mod.cc files. The header file is long; to make it 
more manageable for you to read we have removed most of the comments. 

In the sections that follow, we work our way through the various features of the 
Mod class that these files implement. 
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Program 9.1: Header file for the Mod class, Mod. h. 


#ifndef MOD_H 
#define MOD_H 
#include <iostream> 
using namespace std; 


const long INITIAL_DEFAULT_MODULUS = 


class Mod 
private: 


{ 


long mod; 

dkesavey sietilp 

static long default_modulus; 
void adjust_val() { 


val = 


val%mod; 


if (val<0) val += mod; 


porloyll ake g 
Mod() { 
mod = 
val = 


get_default_modulus(); 
0; 


Mod(long x) { 


mod = 
val = 


get_default_modulus(); 
x} 


adjust_val(); 


Mod(long x, long m) { 


aie (iin 


val = 


mod 
} 


else 


mod = 


val 


<= 0) 4 
0; 
= OF 


{ 
m; 
=x; 


aclymsie_Aweill () ¢ 


long ge 


void se 


if (mod == 0) return; // no change for an invalid object 


val = 
adjus 


long ge 
void se 


aie (i) 
mod 


Ese) Comisie qf seeicibsein syeilke 
t_val(long x) { 
x; 


Ce) 2 


t_mod() const { return mod; 





t_mod(long m) { 
<= 0) i 
= 0; 


2; 


} 


} 
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55 val = 0; 

56 } 

57 else { 

58 mod = mj; 

59 adjust_val(); 

60 } 

61 } 

62 

63 static void set_default_modulus(long m) { 

64 te i eS Gg 

65 default_modulus = INITIAL_DEFAULT_MODULUS; 
66 } 

67 else { 

68 default_modulus = m; 

69 } 

70 } 

71 

72 static long get_default_modulus() { 

73 if (default_modulus <= 0) 

74 set_default_modulus (INITIAL_DEFAULT_MODULUS) ; 
75 return default_modulus; 

716 } 

77 bool is_invalid() const { return mod==0; } 

78 

79 bool operator==(const Mod& that) const { 

80 return ( (val==that.val) && (mod==that.mod) ); 
81 } 

82 

83 bool operator==(long that) const { 

84 return (*this) == Mod(that,mod); 

85 } 

86 

87 bool operator!=(const Mod& that) const { 

88 i@aieuuent ( (yell tS ieleeie wel) |||] (tiercl Y= icinete jmersl)) js 
89 } 

90 

91 bool operator !=(long that) const { 

92 return (*this) != Mod(that,mod) ; 

93 } 

94 

95 bool operator<(const Mod& that) const { 

96 if (mod < that.mod) return true; 

97 if (mod > that.mod) return false; 

98 if (val < that.val) return true; 

99 return false; 

100 } 

101 

102 Mod add(Mod that) const; 

103 

104 Mod operator+(const Mod& x) const { return add(x); } 
105 

106 Mod operator+(long x) const { return add(Mod(x,mod)); } 
107 

108 Mod operator+=(const Modé x) { 

109 *xthis = add(x); 


110 return «this; 
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111 } 

112 

113 Mod operatort+=(long x) { 

114 *xthis = add(Mod(x,mod) ); 

115 return «this; 

116 } 

117 

118 Mod operator-—() const { return Mod(-val,mod); } 
119 

120 Mod operator-—(const Mod&é x) const { 
121 ieSinWien (Gqelsis)) 4> (3x) 9 

122 } 

123 

124 Mod operator-(long x) const { 

125 Wace (elas) a5 (3x) 2 

126 } 

127 

128 Mod operator-=(const Modé x) { 

129 *xthis = add(-x); 

130 return «this; 

131 } 

132 

133 Mod operator-=(long x) { 

134 xthis = «this + (-x); 

135 return «this; 

136 } 

137 

138 Mod multiply (Mod that) const; 

139 

140 Mod operators (const Mod& x) const { return multiply(x); } 
141 

142 Mod operator«(long x) const { return multiply (Mod(x,mod)); } 
143 

144 Mod operator*=(const Mod& x) { 

145 xthis = multiply (x); 

146 return «this; 

147 } 

148 

149 Mod operatorx=(long x) { 





150 xthis = multiply (Mod(x,val)); 
return «this; 


a 
wn 
= 


152 } 

153 

154 Mod inverse() const; 

155 

156 Mod operator/ (const Mod& x) const { return multiply(x.inverse()); } 
157 

158 Mod operator/ (long x) const { 

159 return multiply (Mod(x,mod) .inverse())j; 
160 } 

161 

162 Mod operator/=(const Mod& x) { 

163 xthis = multiply (x.inverse()); 

164 return x*this; 

165 } 


167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 


ee 
FE OoOmAANI ANF WN 


12 


162 C++ for Mathematicians 


Mod operator/=(long x) { 
xthis = multiply (Mod(x,mod) .inverse())j; 
return «this; 
Mod pow(long k) const; 
}; 
ostream& operator<<(ostream& os, const Modé M); 
inline bool operator==(long x, const Mod& y) { 


return (y==x); 


inline bool operator!=(long x, const Mod& y) { 
return (y!=x); 


inline Mod operator+(long x, Mod y) 
return y+x; 





inline Mod operator-(long x, Mod y) 
TORU ye ee 


inline Mod operator*(long x, Mod y) 
ASE OLENA WAP 














inline Mod operator/ (long x, Mod y) 
return y.inverse() * x; 








endif 








Program 9.2: Source file for the Mod class, Mod.cc. 


#include "Mod.h" 
#include "gcdx.h" 


long Mod::default_modulus = INITIAL_DEFAULT_MODULUS; 


ostream& operator<<(ostream& os, const Mod& M) { 
aie (CUMS aS abioryenllaiel(()) ly 


Ost Modi QU Mergetemnv.cilly (iain sMPicieitemsmo.cli(s) 


} 
else { 

Os << WOONAIE IEDM! p 
} 


return os; 


Mod Mod::add(Mod that) const { 


’ 





CAA NDUNPWNK OC 


DDUMMNAMMNAAnnnNn 
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ie (Gee slidiyevibacel()) |] || qelekene< ass abiokyetibauel (()))) seStewuein Wile! (0), 0). 
if (mod != that.mod) return Mod(0,0); 
return Mod(val + that.val, mod); 


} 


Mod Mod: :multiply (Mod that) const { 
aie (ie aboyeulavel (jy || || televene . ale Laser haicl(() )) tere tiain Iiecl (01-0) 5 
if (mod != that.mod) return Mod(0,0); 
return Mod(val * that.val, mod); 





} 


Mod Mod::inverse() const { 
Lone; Gl, ei, leyp 
aie (Cie, abowyeillacl())j) seeiewuzin Mieecl(@, @)) 9 


cl = eel (well, intoyels. ei, Joy) 


if (d>1) return Mod(0,0); // no reciprocal if gcd(v,x)!= 1 
return Mod(a,mod) ; 


} 


Mod Mod::pow(long k) const { 
if (is_invalid()) return Mod(0,0); // invalid is forever 


// negative exponent: reciprocal and try again 
Le OURO. 
return (inverse()) .pow(-k) ; 


// zero exponent: return 1 
if (k==0) return Mod(1,mod) ; 


// exponent equal to 1: return self 
if (k==1) return «this; 


// even exponent: return ( m*(k/2) )*2 
if (k%2 == 0) { 

Mod tmp = pow(k/2); 

return tmpxtmp; 


} 


ff odd exponent: xeturd “om (k=l) 42) je) em 
Mod tmp = pow((k-1)/2); 
return tmpxtmp« («this) ; 








9.3. The default modulus: Static class variables and methods 


The design of the Mod type calls for the notion of a default modulus. The default 
modulus is employed when the user does not specify a modulus. This occurs with the 
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single-argument constructor Mod (long) (described in detail in Section 9.4). Con- 

sider the following code. 

Mod x(6); 

Mod y; 

Y= 5; 

Mod z; 

z = Mod(1); 

For x, we explicitly invoke the single-argument constructor to set x equal to the 

element 6 in Z, where n is the current default modulus. The variable y is first built 

using the default (no-argument) constructor with value 0 in Z, where, as before, 

n is the default modulus. Then the assignment y = 5; implicitly calls the single- 

argument constructor to give y the value 5 in Z,. Finally, the variable z is assigned 

the value 1 € Z,; in this case, we explicitly invoke the single-argument constructor. 
To create and to use a default modulus value, we need to accomplish the following 

tasks. 


e We need a variable to hold the current value of the default modulus. 
e We need an initial value for the default modulus. 
e We need the ability to inspect and to change the value of the default modulus. 


Let’s tackle these one at a time. 

Where should the value of the default modulus be held? The simplistic answer is 
to save it in a variable named default_modulus of type long. However, this does 
not completely answer the question; we need to know where this variable is declared. 

We might make default_modulus a variable in the main procedure, but there 
are many drawbacks to this: we need to remember to include the declaration and 
then we would need to pass it to every Mod method that might need it. This makes 
life too difficult for the programmer. 

Could we make default_modulus an ordinary member variable for the class 
Moa? No. The problem is that each Mod object would hold its own “personal” 
default_modulus. We want one and only one value for default_modulus that 
is common to all Mod objects. 

Could we make default_modulus a global variable? A global variable is one 
that is accessible to all procedures of a program. This is possible, but undesir- 
able. If default_modulus were global, any procedure would be able to modify 
default_modulus and set it to a nonsensical value (such as 0 or —1). We want 
to hide the variable default_modulus and limit access by get and set procedures. 
The set method would ensure that de fault_modulus always holds a sensible value. 
Furthermore, global variables are a dangerous programming trick; different parts of 
the program can access and modify these values in unpredictable ways. 

What we need is a private variable that “belongs” to the entire class Mod and not to 
any one particular object of type Mod. Such a variable is called a static class variable. 


Inside the private section of the Mod class declaration, we have this (line 12 of 
Program 9.1, Mod.h): 
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static long default_modulus; 


This line announces that the class Mod contains a variable named default_modulus 
(of type long) and this value is common to all Mod objects. (By contrast, the private 
class values mod and val vary from one Mod object to another.) 

Unfortunately, this one line does not quite finish the job of setting up this vari- 
able. Somewhere in our program, but outside the class definition, we need to declare 
this variable. (The long class { ... }; just describes the class Mod. The actual 
declaration of a variable takes place ina .cc file.) 

The declaration of default_modulus takes place on line 4 of the file Mod.cc 
(Program 9.2) and looks like this: 


long Mod::default_modulus = INITIAL_DEFAULT_MODULUS; 


Let’s examine this line one step at a time. First, we are declaring a variable of 
type long, so the keyword long begins this line. The name of the variable is 
default_modulus, but it is a member of the Mod class; hence, the full name of 
this variable is Mod: :default_modulus. Finally, we give this variable a value 
(rather than letting C++ give it one). We could have typed a specific number, such as 
10. Thus long Mod::default_modulus= 10; would be acceptable. However, 
we should avoid nameless constants in our programs. So, the header file (see line 6 
of Mod.h, Program 9.1) declares a global constant equal to 2 like this: 


const long INITIAL_DEFAULT_MODULUS = 2; 


(Global constants are good; global variables are bad.) Thus, whenever the program 
starts up, the variable default_modulus has a known value. 


The variable default_modulus is hidden from view because it is sequestered 
in the private section of the class declaration. It is not possible to change this value 
directly in, say, a main() procedure. Only methods belonging to the class Mod 
can access and modify this value. To do this, we create two procedures named 
get_default_modulus and set_default_modulus. 

If we so chose, we could define such methods inside (i.e., inline) the class decla- 
ration like this: 


class Mod { 
public: 


void set_default_modulus(long m) { default_modulus = m; } 
long get_default_modulus() { return default_modulus; } 


}; 


(Because these are class methods, the keyword inline is not required.) 

The problem with this approach is that to change the default modulus, we would 
need to have a variable of type Mod (let’s call it x) and use a statement of the form 
x.get_default_modulus (17) ;. Although this would work, the necessity to con- 
nect these methods to a particular Mod object doesn’t make sense. There’s nothing 
about x that is relevant here. (Note: The proposed code for set_default_modulus 
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is too simplistic; it fails to handle improper values for m such as zero or negative in- 
tegers.) 

The better solution is to declare these methods as static methods; see lines 63—75 
of Mod.h, Program 9.1. 


static void set_default_modulus(long m) { 
if (m <= 0) { 
default_modulus = INITIAL_DEFAULT_MODULUS; 
} 
else { 
default_modulus = m; 
} 
} 


static long get_default_modulus() { 
if (default_modulus <= 0) 
set_default_modulus (INITIAL_DEFAULT_MODULUS) ; 
return default_modulus; 


The modifier st atic for a method means that this method is not associated with an 
object of the given class, but with the class as a whole. So, for example, it would 
not make sense for either of these procedures to access the member variables val or 
mod because they are object specific. 

Use of these methods requires a special syntax. Remember that these methods 
are members of the Mod class, but are not tied to any particular object. If we want 
to use these methods inside another Mod method, we can just use their name (either 
get_default_modulus or set_default_modulus). However, in a procedure 
such as main() another syntax is required. To use a static method from the class 
Mod in a procedure, we need to prepend Mod: : to the name of the procedure. Here 
is an example: 


Mod: :set_default_modulus (10); 
cout << "The default modulus is now 
<< Mod::get_default_modulus() << endl; 


We have seen three usages of the keyword static. Its meaning depends on the 
context in which it is used. 


e A procedure’s variable may be declared static. This means that the value 
held in the variable is preserved between invocations of the procedure. 


e A variable in a class declaration may be declared static. This means that 
this variable is common to all objects of that type. 


e Aclass method may be declared static. This means that this method is not 
to be associated with any particular object of the class, but with the class as a 
whole. Consequently, it cannot access any nonstatic member variables of the 
class. 
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9.4 Constructors and get/set methods 


The Mod class has three constructors. A default constructor that takes no ar- 
guments, a one-argument constructor that uses the default modulus, and a two- 
argument constructor that specifies both value and modulus. The code for three 
constructors is written inline on lines 19-40 of Mod.h (Program 9.1). 

The constructors must ensure that the modulus is positive (or else the resulting 
object is invalid). When the modulus is provided by the default modulus, we can 
be assured that the modulus is nonnegative. However, in the two-argument case, we 
need to check that the modulus specified is positive. If not, we create an invalid Mod 
object. 

The constructors also need to ensure that the value is in the proper range. For 
example, the user may call Mod(-1,10). In this case, we should create 9 € Zjo. 
This need to adjust the value so that it lies in the proper range is a recurring issue, so 
we create a private method to adjust val so that it lies between 0 and mod-1. The 
adjust_val() method is given inline on lines 13-15 of Mod.h (Program 9.1). 


Because the val and mod member variables are private, we need methods to in- 
spect and to modify these. To that end, we specify the inline methods get_val, 
set_val, get_mod, and set_mod on lines 42-61 of Mod.h (Program 9.1). The 
get methods are flagged as const because they do not modify the Mod object. The 
set methods are designed to modify objects. These are designed so that the modulus 
is nonnegative and the value lies in the proper range. 

We allow mod to equal zero to signal an invalid Mod object. We provide a handy 
is_invalid method (line 77) to check if this is the case. 


9.5 Comparison operators 


Given Mod objects x and y, we want to be able to check whether they are equal, 
and to sort them with <. We define the following relational operators: 


* 
ll 
ll 

he 


x l= y x < y 


The == operator is defined inline on lines 79-80 and the != operator on lines 91-93 
of Mod.h (Program 9.1). 

The < operator sorts Mod objects first on the basis of the modulus, and then on the 
basis of the value. See lines 95-100 of Mod.h. 


In addition to comparing Mod objects to other Mod objects, it is convenient to be 
able to compare a Mod object to a long integer. For example, consider this code: 


168 C++ for Mathematicians 


Mod x(9,10); 
if (x == -1) cout << "It worked!" << endl; 


In this case, we want the —1 interpreted as an element of Zo and then the comparison 
ought to evaluate to true. 

In C++, we need to define the operators Mod == long and long == Mod sepa- 
rately. The first of these is given on lines 83-85; we repeat that code here. 


bool operator==(long that) const { 
return (*this) == Mod(that,mod) ; 
} 


The method is type boo1 because it returns a true/false result. The single argument 
is of type long because it is the right-hand argument; the left-hand argument is the 
Moa object. That is, in the statement x == -1 (where x is a Mod), the left argument 
is (implicitly) x and the right argument (that) equals —1. 

The procedure works by converting that into a Mod object with the same modulus 
as the invoking object: Mod (that, mod). Then it uses the already defined Mod==Mod 
operator to compare. In order for an object to use itself we use «this. Therefore, 
when we encounter x == -1, the expression 


(*this) == Mod(that,mod) 


compares x (embodied by «this) with Mod (that,mod) where mod is the modulus 
of x. 


Now we need to write a procedure for expressions of the form long == Mod. 
This cannot be written as a method inside the Mod class because the left-hand argu- 
ment is not of type Mod. We therefore need to define this as a procedure outside the 
curly braces enclosing the Mod class declaration. 

The code for long == Modis on lines 178-180 of Mod.h (Program 9.1) and we 
repeat that code here. 


inline bool operator==(long x, const Mod& y) { 
return (y==x); 


} 


The keyword inline is mandatory here (it is optional for inline methods inside 
the class declaration). Again, the procedure is of type boo! as it returns a true/false 
value. This version of operat or== has two arguments; because this is not a method 
belonging to a class, but rather a free-standing procedure, we need to specify the left 
and right arguments of == explicitly. The left argument is of type long and the right 
is of type Mod. The easiest way to see if x==y is true (where x is a long and y is a 
Mod) is to take advantage of the fact that we already have Mod==1long defined; we 
just invoke y==x. 


All three manifestations of != (Mod! =Mod, Mod!=long, and long! =Mod) are de- 
fined in the same manner. 
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9.6 Arithmetic operators 


Now we implement the various arithmetic operations for Z,: addition, subtraction, 
multiplication, division, and exponentiation. 

We begin with addition. Of course, we want to define the + operator when both 
arguments are type Mod. To do that, we create an operator+ method in the Mod 
class. In addition, it is useful to define Mod+long and long+Mod operations. We 
also want the add/assign operation x += y where x is a Mod and y is either Mod or 
long. 

All of these various forms of addition require the same basic underlying opera- 
tions, we define an add method first and all the various + operations can use that 
to do the work. The add method of the Mod class is declared on line 102 of Mod.h 
(Program 9.1) as follows: Mod add(Mod that) const;. The actual code is found 
on lines 16—20 of Mod. cc (Program 9.2): 

Mod Mod::add(Mod that) const { 

if (is_invalid() || that.is_invalid()) return Mod(0,0); 

if (mod != that.mod) return Mod(0,0); 


return Mod(val + that.val, mod); 


} 


Notice that we first check if either the invoking Mod object or the argument that is 
invalid; if so, we return an invalid Mod object. Also, if the moduli of the two addends 
are different, we return an invalid Mod object. Finally, we add the values of the two 
objects and return a new Mod object containing the sum. 

With the add method in place, we define the various + operators. The Mod+Mod 
method is on line 104 of Mod.cc and the Mod+long is on line 106. The long+Mod 
procedure cannot be a member of the Mod class (because the Mod is not on the left), 
so it is defined as a procedure on lines 186-188 of Mod.h. In each case, the Mod 
object passed is declared const Modé because addition does not modify the addends 
(hence const) and call by reference is required for operators. 

Next we define the += operators. The Mod+=Mod operator’s definition (lines 108— 
111 of Mod. h) is repeated here: 





Mod operator+=(const Modé& x) { 
*xthis = add(x); 
return «this; 


} 


Recall that the effect of the statement a+=x; is tantamount to a=a+x;. C++ allows 
us to program the += operator to do anything we want, but it makes most sense to 
adhere to the intended meaning. 

The statement a=a+x; has the effect of replacing the value held in a with the 
result of the computation at+x. The result of a+=x; is the new value of a. Thus, 
a compound statement of the form z=a+=x; is interpreted as z = (at+=x) and is 
equivalent to a=a+x; z=a;. The procedure we write for Mod+=Mod should adhere 
to this behavior. 
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Thus, the operator+= method returns a Mod value. The argument, x, is declared 
as const Mod& x because (a) the code does not modify x’s value and (b) pass by 
reference is required for operator+=. 

To add x to the invoking object we appeal to the add method already defined. 
The statement «this = add(x); does the required work. The invoking object 
calculates the sum of its own value and that of x, and then assigns that value to itself. 

Finally, we need to return the value in the invoking object as the result of this 
method. This is accomplished with the statement return *this;. 


Next we examine the subtraction methods. Because a—b is equivalent to a+(—b), 
we begin by defining the unary minus (i.e., negate) operator. The unary operator —a is 
a zero-argument method in the class Mod. The reason we do not need any arguments 
is because the operator applies to the invoking object. The full definition of unary 
minus is given inline in Mod.h on line 118 (Program 9.1) and repeated here: 


Mod operator-() const { return Mod(-val,mod); } 


Now the binary minus can be built using unary minus and addition. The Mod-Mod 
and Mod-long operations are implemented as methods within the class Mod (see 
lines 120-126). The 1ong—Mod operator cannot be a member of the Mod class (be- 
cause the left-hand argument is not a Mod), and so it needs to be a stand-alone proce- 
dure outside the class definition. See lines 190-192 of Mod.h. Finally, the Mod-=Mod 
and Mod-=long methods are given on lines 128-136. 


The multiplication operators are created in a manner similar to that of addition. We 
declare a multiply method on line 138 of Mod.h and then give the code in Mod. cc 
on lines 22-26. The Mod«Mod, Mod*long, Mod*=Mod, and Mod*=long operators 
are inline members of the Mod class (lines 140-152 of Mod.h, and long*Mod is an 
ordinary inline procedure outside the class definition (lines 194-196). 


We reduce division a+ b to multiplication by a reciprocal; that is, a x b~!. There- 
fore, we begin by building an inverse method for the Mod class. This method 
is declared on line 154 of Mod.h as follows: Mod inverse() const;. Invoking 
b.inverse() should return the multiplicative inverse of b (in the appropriate Z,,) 
if possible; otherwise (i.e., b is not invertible) we return an invalid result. This is 
implemented in Mod. cc on lines 28-36; we repeat the code here: 


Mod Mod::inverse() const { 
long d,a,b; 
if (is_invalid()) return Mod(0,0); 


d = gcd(val, mod, a, b); 


if (d>1) return Mod(0,0); // no reciprocal if gcd(v,x)!= 1 
return Mod(a,mod) ; 


} 


The code first checks if the invoking Mod object is valid; if not, no inverse is possible 
and we return an invalid result. We then invoke the extended gcd procedure to find 
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integers a and b so that axval+b*mod equals d=gcd (val, mod). If d equals 1, then 
a holds the value of the inverse. 

With the inverse method established, we use it to define Mod/Mod, Mod/long, 
long/Mod, Mod/=Mod, and Mod/=long. 


There are a large number of arithmetic operators, but they all trace their actions 
back to four methods: add, multiply, unary minus, and inverse. There is an 
interesting benefit to this approach. Suppose we think of a better way to perform 
these operations; rather than needing to rewrite myriad operator methods, we just 
need to update these few to implement the new methods. For example, on a computer 
for which a long is four bytes, the largest integer value is around two billion. If 
we are working in a modulus near that limit and we multiply two Mod objects, the 
intermediate result may overflow the long data type. See line 25 of Mod. cc in which 
we calculate val * that.val. If val and that.val are both greater than, say, 
10°, then the multiply procedure gives an incorrect result. To fix this problem, we 
could rewrite the procedure to save val and that.valin long long variables, and 
then perform the multiplication. We would then reduce modulo mod which brings 
the values back to within the proper range. 


The final operation we implement is exponentiation. Given a € Z, and k € Z, we 
want to calculate a‘. If k is negative, we raise a~! to a positive power. Rather than 
multiply a by itself repeatedly, it is more efficient to use repeated squaring. Note that 


(a‘/2)? if kis even, and 


k 2 
(av?) Sa) Ge PaS odd, 


Ge = 


So, calculating a‘ by this strategy uses O(log, k) multiplications and not the far 
greater k — | required by the naive method. 

We call the method pow and it is declared on line 172 of Mod.h and the code is on 
lines 38-61 of Mod.cc. 

We elected not to define any operator symbol to represent exponentiation. Two 
natural operator symbols would make sense: »* and *. Unfortunately, there are 
problems with both. The first is simply illegal. Because C++ does not have a «* 
operator for its fundamental types, we are not permitted to use ** as an operator 
symbol for any other types. 

The latter, *, is permissible because ~ is a valid C++ operator (exclusive or). 
Within the Mod class we may define this operator such as this: 


Mod operator” (long k) { return pow(k); } 


Then, in a procedure (such as main) we could have statements such as a = b°5; in 
lieu of a = b.pow(5);. 

The problem is C++’s order of operation rules. C++ knows that multiplication 
takes priority over addition. An expression such as axb+cxd is parsed as expected: 
(axb) +(c*d). However, in the C++ hierarchy of operations, * has lower priority 
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than addition. Thus a statement of the form a+b*2 would be parsed as (a+b) *2. 
If we defined ~ for the Mod class, we would need to be careful to add unnatural 
parentheses in our expressions. Fortunately, the . in a.pow(k) has priority over 
addition and multiplication. So the expressions at+b*c.pow(k) and atc.pow(k) 
have the desired behavior. There is no way to change C++’s order of operation rules, 
so we elect not to use operator~ for exponentiation. 





9.7 Writing Mod objects to output streams 


One last task awaits us: writing Mod objects to an output stream such as cout. The 
technique for doing this is the same as for Point and PTriple objects. In Mod.h 
(line 176) we declare operator<< as a two-argument procedure: 


ostream& operator<<(ostream& os, const Modé& M); 
Then, in Mod. cc (lines 6-14) we give the code. If the Mod object is invalid, we write 


the characters INVALID. Otherwise, we write a Mod object in a form such as this: 
Mod (31,100). 





9.8 A main to demonstrate the Mod class 


We end this chapter with a simple main to demonstrate the use of the Mod class. 





Program 9.3: A program to illustrate the use of the Mod class. 
#include "Mod.h" 


/// A main to test the Mod class 


int main() { 
IMleYel <p aWin VAR 


x.set_default_modulus (11); 


x = Mod(17,10); 


y = Mod(24); 

B= <3 

Come << We Y << x << Giaiellls 
come K< Why TY x< Wax Ginelily 


cout << "Zz = " << z << endl << endl; 


COU: Re yee SM ke Pee ee en: 
Coie, K< Wars SN KS We SS Shoiclib 
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Crest, <<< Wyre ON KK Wear << Syrochib 
cout << "y/z =" << y/z << endl << endl; 
come << “xargs = W «6x xargs << Ginelike 
eoue, «<< Vx 3 " << x-3 << endl; 
Gow <— tors) = V << nets) <<< Saclily 
Coulis << V/s = Y K< mf} KK Ciniclll << Grevelilp 
@leybhe, Kec USES NN Ree Hite cee ehololbeg 
Gower << Vilas, = W se dose << ieinyelilp 
Goume << Vales = Wo se dlse << ieinvelilp 
eee KK Wise = UW «<x Wise << ieipyelll << Giayelils 
Coue << Yow = K&S Se <x incl << Giavelllp 
Come << US. SW << sx joo) «<< einelils 
eoue << Wx (9) = VY «<< xajoen(—S)) «<< Ginelils 
cou K< Vain 1G = Wo << Silenyojoour(il@)) «<< eyorelils 
cout, ee "a2 “= 8 Kk yy pow (eh << endl; 
Goue «<< “Sy (=2)eal = WY << sy joenn(=2)) srk << eich << Gisvelilp 
cout «oe S UE a Ae Se 17) ee endl 
Gowme <<. Wee eS aye Ke OR TS Wy <<< Ghayelils 
cout << "17 == x\t" << (17 == x) << endl; 
eine KK Wily eS ok in eK Ga fh 5x)) xe Sinilill <<< Shayelil-e 
return 0; 

} 

ere is the output of this program. 

H th tput of th 

x = Mod(7,10) 

y = Mod(2,11) 

z = Mod(8,11) 

yt+z = Mod(10,11) 

y-z = Mod(5,11) 

y*xz = Mod(5,11) 

y/z = Mod(3,11) 

x+3 = Mod(0,10) 

x-3 = Mod(4,10) 

x*3 = Mod(1,10) 

x/3 = Mod(9,10) 

4+x = Mod(1,10) 

4-x od (7,10) 

4xx = Mod(8,10) 

4/x = Mod(2,10) 

-x = Mod(3,10) 

x°9 = Mod(7,10) 

x*(-9) = Mod(3,10) 
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-1+y*10 = Mod(0,11) 
y°2 = Mod(4,11) 
y* (-2)+1 = Mod(4,11) 








9.9 Exercises 


9.1 Write a procedure to solve a pair of congruences of the form 


where m and 7 are relatively prime. The existence and uniqueness (in Zn,) 
of the solution to such a problem is guaranteed by the Chinese Remainder 
Theorem. Therefore, call your procedure crt. It should take two Mod objects 
as arguments and produce a Mod value in return. Your procedure should be 
declared like this: 


Mod crt(const Mod a, const Mod b); 


Of course, you may use the procedure you developed in Exercise 5.4. 


9.2 Create a class to represent the time of day. Call your class Time and give it the 
following attributes. 


e The data should be held in three private variables representing the 
hour, minute, and second. 


e The default (no-argument) constructor should create a value equal to 
midnight and a three-argument constructor should create the time speci- 
fied (using hours from 0 to 23). 


e Define addition of a Time object and a (long) integer. If T is type Time 
and n is type long, then T+n and n+T should be the time n seconds after 
T. (Of course, n might be negative.) 


e Define subtraction, but only in the form T-n but not n-T. 


e Define ++ and —--; these should increase (decrease) T by one second, 
respectively. 


e Define get_hour(), get_minute(), and get_second() methods. 
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e Define ampm() and military() methods to control how the time is 
printed (see the next bullet). These methods should affect how all Time 
objects are printed. 


Also provide a is_ampm() method that returns t rue if the current out- 
put style is to use AM/PM and false if the current style is military (24 
hour). 


e Define << for printing Time objects to the screen. The style of the output 
should either be 5:03:24 pmor 17:03:24 as specified by the user with 
the methods ampm() and military (), respectively. 


Note the zero in front of the 3 but not in front of the 5. Midnight 
should be reported either as 12:00:00 am or 0:00:00 and noon as 
12:00:00 pmor 12:00:00, as appropriate. 


If you are feeling especially brave, you can create a procedure called now that 
returns the current time of day. You can use t ime (0) ; this returns the number 
of seconds since midnight on a specific date but not necessarily in your time 
zone (unless your local clock is GMT). 


9.3 Create a class named EuclideanVector to represent vectors in a Euclidean 
space R”, and give it the following attributes. 





e There should be a default dimension (as a static class variable). Give 
static methods for inspecting and adjusting this default dimension. 


e There should be a zero-argument constructor that gives the zero vector in 
the default dimension. There should also be a single-argument construc- 
tor EuclideanVector (int n) that creates the zero vector in R”. 





e There should be methods to get and set the individual coordinates of the 
vector. 


e There should be a method to learn the dimension of the vector. 


e There should be an operator+ for adding vectors. Decide what the 
behavior should be in case the two vectors are of different dimension. 


e There should be an operator method for scalar multiplication. Be 
sure to allow both scalar—vector and vector-scalar multiplication. 


e There should be an operator== and an operator!= for comparing 
vectors for equality. 


e There should be an operator<< for writing vectors to the computer 
screen. 


9.4 Let S denote the set {,/n:n € Z,n > 0}. Define an operation * on S by x*¥y = 
\/x2 +y?. Create a C++ class to represent elements of the set S that includes 
an operator» that implements S’s operation. 


Include methods to get the value n, to convert an element of S into a decimal 
approximation, and an operator<< to write elements of S to the screen. 
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9.5 Create a class to represent Hamilton’s quaternions. 


The quaternions are an extension to the complex numbers. Each quaternion 
can be written as a+ bi+cj+dk where a,b,c,d € R and i,j,k are special 
symbols with the following algebraic properties: 


Addition is defined as expected: 
(a+bit+cj+dk)+(a'+b/i+c j+d'k) 
=(a+a’)+(b+b')it(c+c)j+(d+d')k. 


Multiplication is not commutative (as evidenced by the fact that ij 4 ji), but 
otherwise follows the usual rules of algebra. For example, 


(1+2i+3j—4k)(—2+i+2j+5k) = 10+ 20i— 18) + 14k. 


The set of quaternions is denoted by H. 


Include the standard operators +, - (unary and binary forms), «, and /, and the 
combined assignment forms +=, -=, «=, and /=. 











Also include the standard comparison operators == and ! =, plus an << operator 
for writing quaternions to the screen. 


Chapter 10 


The Projective Plane 


In this chapter we develop C++ classes to represent points and lines in the projective 
plane. Because such points and lines share many properties the classes and methods 
for their classes are extremely similar. Rather than write two nearly identical classes, 
we first build a base “projective object” class that implements the common function- 
ality. We then use the idea of inheritance to establish classes representing points and 
lines. 











10.1 Introduction to the projective plane, RP? 





The points of the Euclidean plane R? are ordered pairs of real numbers (x,y). 
Lines are point sets of the form {(x,y) : ax + by =c} where a,b,c € R and ab £0. 

The projective plane RP? is an extension of the Euclidean plane. To the points in 
R? we add additional points “at infinity.” These points are in one-to-one correspon- 
dence with the slopes of lines in the Euclidean plane. More formally, we say that two 
lines in the Euclidean plane are equivalent if they are parallel. The points at infinity 
of the projective plane are in one-to-one correspondence with the equivalence classes 
of parallel lines. In RP*, each line from the Euclidean plane is given one additional 
point corresponding to its slope. Finally, all the points at infinity are deemed a line 
as well, and this line is called the line at infinity. 

Alternatively, the points in RP? are in one-to-one correspondence with (ordinary) 
lines through the origin in R*. The lines of RP? correspond to (ordinary) planes 
through the origin in R?. 

This leads to a natural way to assign coordinates to the points of RP*. Every point 
in RP? is assigned a triple of real numbers (x,y,z). Two triples name the same point 
provided they are nonzero scalar multiples of each other. For example, (2,4,—10) 
and (—1,—2,5) name the same point. The triple (0,0,0) is disallowed. 

The original points of the Euclidean plane correspond to triples in which z is 
nonzero. The point (x,y, 1) € RP? is identified with the point (x,y) in the Euclidean 
plane. Points at infinity are identified with triples in which z= 0. 

Lines in the projective plane are sets of the form { (x,y,z) € RP? : ax+ by+cz=0} 
where a,b,c € R and are not all zero. For example, (1,2,3), (1,1,3), and (1,—2,0) 
are collinear points as they all lie on the line { (x,y,z) : 2x+-y—z=0}. It is convenient 
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to name lines as a triple [a,b,c]: 
[a,b,c] = {(x,y,z) :ax+ by +cz = 0}. 


We use square brackets to name lines so we don’t confuse points and lines. Note 
that if [a’,b’,c’] is a nonzero scalar multiple of [a,b,c], then the two triples name the 
same line. The line at infinity is (0,0, 1]. Only the triple [0,0,0] is disallowed. 

To determine if a point (x,y,z) is on a line [a,b,c], we simply need to check if the 
dot product ax + by + cz equals zero. 

From our discussion, we see that there is a duality between points and lines in the 
projective plane. Given any true statement about points and lines in RP?, when we 
exchange the words “point” and “line” (plus some minor grammar correction) we 
get another true statement. For example, the following dual statements are both true: 


e Given two distinct points of the projective plane, there is exactly one line that 
contains both of those points. 


e Given two distinct lines of the projective plane, there is exactly one point that 
is contained in both of those lines. 


One of the celebrated results in projective geometry is the following. 


Theorem 10.1 (Pappus). Let P,,P2,P3 be three distinct collinear points and let 
Q,,Q2,Q3 be three other distinct collinear points. Let X; be the intersection of the 
lines P;Q, and P,Q ; where i, j,k are distinct and 1 <i, j,k < 3. Then the three points 
X1,X2,X3 are collinear. O 


Pappus’s theorem is illustrated in Figure 10.1. 
The dual statement to Pappus’s theorem is this. 


Theorem 10.2 (Dual to Pappus). Let L;,L2,L3 be three distinct concurrent lines 
and let M, ,M2,Ms3 be three other distinct concurrent lines. Let X; be the line through 
the points of intersection L; 1M, and Ly.\M; where i, j,k are distinct and satisfy 
1 <i, j,k <3. Then the three lines X,,X2,X3 are concurrent. O 


The dual to Pappus’s theorem is illustrated in Figure 10.2. 


10.2 Designing the classes PPoint and PLine 


Our goal is to create C++ classes to represent points and lines in the projective 
plane. We call these PPoint and PLine. We need to decide how to represent these 
objects (i.e., what data are needed to specify the objects) as well as the methods, 
operators, and procedures that act on these objects. 

Here are our decisions. 
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Figure 10.1: An illustration of Pappus’s theorem. 





Figure 10.2: An illustration of the dual of Pappus’s theorem. 
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e Points are to be stored as triples (x,y,z) giving the homogeneous coordinates 
of the point. 


Likewise, lines are to be stored as triples, [x,y,z]. 


e We want to be able to test points for equality (and inequality) and sort by < so 
they can be held in C++ containers such as sets. 


Likewise, we need to be able to test lines for the same relations. 


e Given two points, we want to be able to find the unique line that contains them. 
However, if the two points are the same, we return an invalid point; we signal 
this with coordinates (0,0,0). For points x and Y, the notation X+¥ is a good 
way to express the line through x and y. 


Likewise, given two lines, we want to be able to find the unique point of inter- 
section of these lines. However, if the two lines are the same, then we return 
an invalid line; we signal this with the triple [0,0,0]. For lines L and M, the 
notation L«M is a good way to express the point of intersection. 


e Given a point and line, we want to be able to determine if the point lies on the 
line. 


e We want to be able to determine if three points are collinear. 


Likewise, we want to be able to determine if three lines are concurrent. 


e We want to be able to generate a random point or line in the projective plane. 


In addition, given a line, we want to be able to choose a random point on the 
line. Likewise, given a point, we want to choose a random line through the 
point. 


e We want to be able to send points and lines to output streams, writing points 
in the form (x,y,z) and lines in the form [x,y,z]. 


Notice that nearly every requirement for points has a matching requirement for 
lines. Thus, the code we need to write in the two instances would be nearly identical. 
To cut our work load in half, we exploit C++’s inheritance mechanism. We create a 
parent class named PObject that has two children: PPoint and PLine. As much 
as possible, we embed the functionality we need in the parent class, and then the 
children access this functionality for their own purposes. 

In addition to reducing the workload in creating the classes, putting the common 
functionality of the classes into the parent reduces our workload in maintaining the 
classes. If there is an error in an algorithm, or if we create a more efficient version of 
the algorithm, we only need to replace the code in the parent class; we do not need 
to edit two separate versions. 
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10.3 Inheritance 


Before we create the classes PPoint and PLine, we illustrate how one class is 
derived from another. That is, a class (let’s call it Parent) is created first with certain 
properties. Then we create a new class (call it Child) that has all the properties of 
Parent plus additional properties. 

For the toy example we are about to present, the Parent class houses two double 
real values, x and y. We provide a simple constructor to set x and y and two methods: 
sum() that calculates the sum x+y and print() that writes the object to the screen 
in the format (x,y). 

The Child retains all the data and functionality of Parent but adds the follow- 
ing additional features. The new class has an additional data element: an integer 
k. It provides a new method value() that returns (x+y) *k and a new version of 
print() that writes the Child object to the screen in the format (x,y) *k. 

Here is the code that accomplishes all these tasks. 


Program 10.1: A program to illustrate inheritance. 


#include <iostream> 
using namespace std; 


class Parent { 
private: 
double x, y; 
public: 
Parent(double a, double b) { x = a; y = b; } 
double sum() const { return xty; } 
‘eutel joraiine()) Coste { Cee ae ( << xe ae 1, ee sy se TM) } 


he 


class Child : public Parent { 
private: 
int k; 
public: 
Child(double a, double b, int n) : Parent(a,b) { 
k =n; 
} 
double value() const { return sum()x*k; } 
VOld pirat) CONS ite eebakentis)s 9% mitcl(l) smc OUltmt< <a ra <<ikacuu) 


he 


int main() { 
Parent P(3., <2). }¢ 
Pepin (|)ie 
cout << " --> " << P.sum() << endl; 


ChavlialeG)(—iey siete) 
C.print(); 
cout << " --> " << C.sum() << " --> " << C.value() << endl; 
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return 0; 


} 


The Parent class is defined on lines 4-11. There is nothing new in this code; we 
have kept it short and simple to make it easy for you to read. Please look through it 
carefully before moving on. 

The Child class is defined on lines 13—22 and there are several important features 
we need to address. 


e To begin, the class Child is declared to be a public subclass of the class 
Parent on line 13: 


class Child : public Parent { 


The words class Child announce that we are beginning a class definition. 
The colon signals that this class is to be derived from another class. (Ignore 
the word public for a moment.) And the word Parent gives the name of the 
class from which this class is to be derived. 


The keyword public means that all the public parts of Parent are inherited 
as public parts of the derived class Child. The Child class has full access to 
all the public parts of Parent but does not have any access to the private parts 
of Parent. 


(Aside: Had we written class Child : private Parent then the public 
parts of Parent would become private parts of Child. As in the case of public 
inheritance, the private parts of Public are not accessible to Child.) 


e On lines 14-15 we declare a private data element for Child: an integer k. The 
class Child therefore holds three data elements: x, y, and k. 


A method in Child can access k but not x or y. The latter are private to 
Parent and children have no right to examine their parents’ private parts. 


e Next comes the constructor for the Child class (lines 17-19). The constructor 
takes three arguments: real values a and b (just as Parent does) and additional 
integer value n (to be saved in k). 


What we want to do is save a, b, and n in the class variables x, y, and k, 
respectively. However, the following code is illegal. 
Child(double a, double b, int n) { 


x =a; y=b; k=n; 


} 


The problem is that Child cannot access x or y. 


Logically, what we want to do is this: first, we want to invoke the constructor 
for Parent with the arguments a and b. Second, we do the additional work 
special for the Child class, namely, assign n to k. 
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Look closely at line 17. Before the open brace for the method we see a colon 
and a call to Parent(a,b). By this syntax, a constructor for a derived class 
(Child) can pass its arguments to the constructor for the base class (Parent). 


The general form for a constructor of a derived class is this: 


derived_class(argument list) : base _class(argument_sublist) { 
more stuff to do for the derived class; 


} 


When the derived class’s constructor is invoked, it first calls its parent’s con- 
structor (passing none, some, or all of the arguments up to its parent’s construc- 
tor). Once the base class’s constructor completes its work, the code inside the 
curly braces executes to do anything extra that is required by the derived class. 


e Next we implement the value( ) method (line 20). This procedure returns the 
quantity (x+y) *k. Although we have no access to x and y, the sum( ) method 
of Parent is public and so we can use that to calculate x+y. Because sum( ) 
is a public method of Parent, it is automatically a public method of Child. 
The expression sum()*k invokes the sum() method (to calculate x+y) and 
we multiply that by k (which is accessible to Child). 


e Finally, we implementa print() method for the Child class (line 21). Recall 
that Parent already has a print() method, so this new print() method 
overrides the former. If P is an object of type Parent and C is an object of 
type Child then P.print() invokes the print () method defined on line 10 
and C.print() invokes the one on line 21. 


The new print() method writes the object to the computer screen in the 
format (x,y) *k. This print() cannot access x or y. Of course, we could add 
public getX() and gety() methods to Parent. However, there is another 
solution. 


The print() method in Parent does most of the work already. Instead of 
rewriting the part of the code that prints (x,y), we just need to use Parent’s 
print() method. The following code, however, does not work. 


void print() const { print(); cout << "*" << k; } 
The problem is that this code is recursive—it invokes itself. We want the 
second appearance of print to refer to Parent’s version. We accomplish 


that by prepending Parent:: to the name of the method. The correct code 
for Child’s print() is this: 


void print() const { Parent::print(); cout << "*" << k; } 


When Child’s print() executes, it first calls Parent’s version of print( ) 
(which sends (x,y) to the screen). The remaining step (sending *k) occurs 
when the second statement executes. 


A simple main follows (lines 24—34); here is the output of the program. 
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(3,-2) --> 1 
(-1,3)*5 --> 2 --> 10 


10.4 Protected class members 


When we derive a new class from a base class, the public members of the base 
class are inherited as public members of the derived class, but the private members of 
the base class are inaccessible to the derived class. C++ provides a third alternative to 
this all-or-nothing access inheritance. In addition to public and private sections, 
a class may have a protected section. Both data and methods may be declared 
protected. 

A protected member of a class becomes a private member of a derived class. A 
child class can access the public and protected parts of its parent, but not the private 
parts. A grandchild of the base class cannot access the protected parts of the base 
class. Let’s look at an example. 


Program 10.2: A program to illustrate the use of protected members of a class. 


#include <iostream> 
using namespace std; 


class Base { 
private: 
ant: ay 
protected: 
nite bis 
int sum() const { return atb; } 
public: 
Base(int x, int y) { a=x; b=y; } 
VOlClEp ising) lc ONG mmc OUt- i <<a (mn <n <<< <<) 


he 


class Child : public Base { 

public: 
Child(int x, int y) : Base(x,y) { } 
void increase _b() { btt; } 


void print() const { Base::print(); cout << "=" << sum(); } 
}; 
class GrandChild : public Child { 
private: 
int <c} 
public: 


Grand@haalid((aintwe <7 anicays nice) )ismeChanlicl (Gq, ya\ cl sezis nn) 
VOLde print ()mconsitm sBasesi:\pranit())) pC Ob << nl//Ma<<iGlenny 


he 
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int main() { 
Base BCL, 2)s 
Child C(3,4); 
GrandChild D(5,6,7); 


B.print(); cout << endl; 
// cout << B.sum() << endl; // Illegal, sum is protected 


CapiEtnt())iCOUtm << ——> als 
C.increase_b(); 
C.print(); cout << endl; 


D.print(); cout << " --> "; 
D.increase _b(); 
D.print(); cout << endl; 


return 0; 


In this program we define three classes: Base, Child, and GrandChild; each is 
used to derive the next. 


The Base class has two data members: a private integer a and a protected integer 
b. The class also includes a protected method named sum, a public constructor, and 
a public method named print. 


Class Child has no additional data members. It has a public method increase_b 
that increases the data member b by one. Note that it would not be possible for 
Child to have a similar method for increasing a. The constructor for Child passes 
its arguments on to its parent, Base, but then takes no further action (hence the curly 
braces on line 17 do not enclose any statements). 


The print method for Child uses Base’s print method and sum method. 


Class GrandChild adds an extra private data element, c. The constructor for 
GrandChild passes its first two arguments to its parent’s constructor and then uses 
the third argument to set the value of c. 


The print method for GrandChild uses its grandparent’s print method. Al- 
though Base: :print() invokes the sum method, the Grandchild methods cannot 
directly call sum because it is protected in Base, hence implicitly private in Child, 
and hence inaccessible in GrandChild. 


A main to illustrate all these ideas begins on line 30. The output of the program 
follows. 


(1,2) 
(3,4)=7. --> (3,5)=8 


(5,6)/7. --> (5,7)/7 
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10.5 Class and file organization for PPoint and PLine 


Because of the duality between points and lines in the projective plane, most of 
the data and code we use to represent these concepts in C++ are the same. If at all 
possible, we should avoid writing the same code twice for two reasons. First, the 
initial work in creating the programs is doubled. More important, maintaining the 
code is also made more difficult; if a change is required to the code, we need to 
remember to make that change twice. When we are fussing with our programs and 
making a number of minor modifications, it is easy to forget to update both versions. 
To illustrate this, we deliberately include a subtle flaw in the first version of the 
program; we then repair the problem once (not twice). 

To this end, we define three classes: a parent class named PObject that contains 
as much of the code as possible and two derived classes, PPoint and PLine, that 
include code particular to each. These classes are defined in two files each: a header 
-h file and a code .cc file. Figure 10.3 illustrates the organization. 





PObject 
PObject.h 
PObject.cc 


—' 














PPoint PLine 
PPoint.h PLine.h 
PPoint.cc PLine.cc 

















Figure 10.3: Hierarchy of the PObject classes. 


The header file PObject.h is used to declare the PObject class. Both PPoint.h 
and PLine.h require the directive #include "PObject.h". Programs that use 
projective geometry need all three. Rather than expecting the user to type multiple 
#include directives, we create a convenient header file that includes everything we 
need. We call this header file Projective.h; here it is. 


Program 10.3: Header file for all projective geometry classes, Projective.h. 


#ifndef PROJECTIVE_H 
#define PROJECTIVE_H 
#include "PPoint.h" 
#include "PLine.h" 
#endif 
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Notice that we do not require #include "PObject.h" because that file is al- 
ready #included by PPoint.h and PLine.h. All these files have the usual struc- 
ture to prevent multiple inclusion. 

All told, we have seven files that implement points and lines in the projective 
plane. 


PObject.h The header file for the PObject class. 
PObject.cc The C++ code for the PObject class. 
PPoint.h The header file for the PPoint class. 
PPoint.cc The C++ code for the PPoint class. 
PLine.h The header file for the PLine class. 
PLine.cc The C++ code for the PLine class. 


Projective.h The only header file subsequent programs need to include to use 
projective points and lines. 


The decision to write the program in seven different files is based on the principle 
of breaking a problem down to manageable sizes and working on each piece sep- 
arately. We could have packed all this work into two larger files (one .h and one 
sGC): 


10.6 The parent class PObject 


Data and functionality common to PPoint and PLine are implemented in the 
class PObject. Using the ideas presented in Section 10.2, we map out the class 
PObject. 


Data A point or line in RP? is represented by homogeneous coordinates: (x,y,z) or 
[x,y,z]. To hold these coordinates, we declare three private double variables, 
x, y, and z. Let us write (x,y,z) for the homogeneous coordinates of a generic 
projective object (either a point of a line). (See Program 10.4, line 9.) 


Because (2,1,—5) and (—4,—2,10) name the same object, it is useful to 
choose a canonical triple. One idea is to make sure that (x,y,z) is a unit vector 
(but then we have a sign ambiguity). The representation we use is to make the 
last nonzero coordinate of the triple equal to 1. The motivation for this choice 
is that a point in the Euclidean plane at coordinates (x,y) corresponds to the 
point (x,y, 1) in the projective plane. 

If later we are unhappy with this decision, we can choose another manner 
to store the homogeneous coordinates. Because the coordinates are private 
members of PObject, we would only need to update the code for PObject. 
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We provide public methods getx(), getY(), and getZ() to inspect (but 
not modify) the values held in x, y, and z, respectively. (See Program 10.4 
lines 33-35.) 


We reserve (0,0,0) to stand for an invalid projective object. We provide a pub- 
lic method is_invalid() to check if an object is invalid. (See Program 10.4 
lines 37-39.) 


Constructors It is natural to define a constructor for a PObject with three parame- 
ters that set the homogeneous coordinates of the object. The user might invoke 
the constructor like this: 


PObject P(2., 3., 5.); 


Rather than holding this point as (2,3,5), we use the canonical representation 
(0.4,0.6,1). (See Program 10.4 lines 25-30.) 


To facilitate the conversion of user-supplied coordinates to canonical coordi- 
nates, we create a private helper procedure scale. (See Program 10.4 line 10 
and Program 10.5 lines 4-19.) 


All C++ classes ought to define a zero-argument constructor that creates a 
default object of that class. In this case, a sensible choice is the object (0,0, 1). 
This corresponds to the origin (as a point) or the line at infinity (as a line). (See 
Program 10.4 lines 21-24.) 


Relations We want to be able to compare projective points (and lines) for equality, 
inequality, and < (for sorting). To this end, we might be tempted to define 
operator== in the public portion of PObject like this: 


public: 
bool operator==(const PObject& that) const { 
return ( (x==that.x) && (y==that.y) && (z==that.z) ); 
} 


Although this would give the desired result when comparing points to points 
or lines to lines, it would also provide the unfortunate ability to compare points 
to lines. Were we to use the above method for testing equality, then we might 
run into the following situation. 


PPoint P(2., 3., 5-); 
PLiné L( 26, 3; 5) 
if (P ==L) { 
cout << "They are equal." << endl; 


} 
When this code runs, the message They are equal would be written on the 
computer’s screen. 


There are at least two problems with this approach. First, the point (2,3,5) and 
the line [2,3,5] are not equal even though they have the same homogeneous 
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coordinates. Second, lines and points should not even be comparable by ==. 
Code that compares a point to a line is almost certainly a bug; the best thing in 
this situation is for the compiler to flag such an expression as an error. 


We therefore take a different approach to equality testing. We want the fun- 
damental code that checks for equality to reside inside the PObject class be- 
cause that code is common to both PPoint and PLine. We do this by declar- 
ing a protected method called equals inside PObject (see Program 10.4 
line 14): 


protected: 
bool equals(const PObject& that) const; 


In the file PObject.cc we give the code for this method (see Program 10.5 
lines 34—36): 


bool PObject::equals (const PObject& that) const { 
return ( (x==that.x) && (y==that.y) && (z==that.z) ); 
} 


Then, in the class definitions for PPoint and PLine we give the necessary 
operator definitions. For example, in PLine we have this: 
public: 

bool operator==(const PLine& that) const { 


return equals(that) ; 


} 
bool operator!=(const PLine& that) const { 
return !equals(that); 


} 


In this way, if (indeed, when) we decide to change the manner in which we test 
for equality, we only need to update PObject’s protected equals method. 


Similarly, rather than defining a < operator for PObject, we define a protected 
less method. The children can access less to define their individual, public 
operator< methods. (See Program 10.4 line 15 and Program 10.5 lines 38— 
45.) 


Meet/Join Operation Given two PPoints P and Q, we want P+0 to return the line 
through those points. Dually, given PLines L and M, we want LM to return 
the point of intersection of these lines. 


In both cases, the calculations are the same: given the triples (x1,y1,z1) and 
(x2,2,22) we need to find a new triple (x3, y3,z3) that is orthogonal to the first 
two. To do this, we calculate the cross product: 


(X3,93,23) = (%1,91,21) X (X25 92522). 


Therefore, in PObject we declare a protected method called op that is invoked 
by operator+ in PPoint and operators in PLine. (See Program 10.4 
line 18 and Program 10.5 lines 138-148.) 


190 C++ for Mathematicians 


Incidence Given a point and a line, we want to be able to determine if the point lies 
on the line. If the coordinates for these are (x,y,z) and [a,b,c], respectively, 
then we simply need to test if ax-+ by+cz=0. 


It does not make sense to ask if one line is incident with another, so we do not 
make an “is incident with” method publicly available in PObject. Rather, we 
make a protected incident method (that calls, in turn, a private dot method 
for calculating dot product). (See Program 10.4 lines 11,16 and Program 10.5 
lines 21—23,47-49.) 


Then, PPoint and PLine can declare their own public methods that access 
incident. Details on this later. 


Collinearity/Concurrence Are three given points collinear? Are three given lines 
concurrent? If the three objects have coordinates (x1,y1,Z1), (%2,2,Z2), and 
(x3,93,23), then the answer is yes if and only if the vectors are linearly depen- 
dent. We check this by calculating 


X1 Y1 Z1 
det | X2 yo Z2 
X3 3 23 


and seeing if we get zero. In PObject.h we declare a procedure dependent 
that takes three PObject arguments and returns true or false. We then use 
dependent to implement procedures collinear and concurrent for the 
classes PPoint and PLine (respectively). (See Program 10.4 line 44 and 
Program 10.5 lines 60-77.) 


Random points/lines There is no way to generate a point uniformly at random in 
the Euclidean plane, but there is a sensible way in which we can do this for 
the projective plane. Recall that points in RP? correspond to lines through the 
origin in R?. Thus, to select a point at random in RP? we generate a point 
uniformly at random on the unit ball centered at the origin. An efficient way to 
perform this latter task is to select a vector v uniformly in [—1, 1]. If ||v|| > 1, 
then we reject v and try again. 


The method for generating a random line is precisely the same. 


We therefore include a public method randomize that resets the coordinates 
of the PObject by the algorithm we just described. (See Program 10.4 line 31 
and Program 10.5 lines 25-32.) 


To choose a random line through a point is similar. Suppose the point is 
(x,y,z). The line [a,b,c] should be chosen so that [a,b,c] is orthogonal to 
(x,y,z). To do this, we find an orthonormal basis for (x,y,z)+ that we denote 
{(a1,b1,¢1), (a2,b2,c2)}. We then choose ¢ uniformly at random in [0,2z]. 
The random line [a,b,c] is given by 


a=a,cost+a)sint b=b,cost+b2sint c=c,cost+cp?sint. 
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Rather than generate ¢ and then compute two trigonometric functions, we can 
obtain the pair (cost,sint) by choosing a point uniformly at random in the unit 
disk (in R?) and then scaling. 


The technique for selecting a random point on a given line is exactly the same. 


Thus, we define a protected rand_perp method in PObject (Program 10.4 
line 17 and Program 10.5 lines 79-136). 


The rand_perp method is used by rand_point in PLine and rand_line 
in PPoint. 


Output Finally, Pobject.h declares a procedure for writing to an output stream. 
The format is <x,y,z>. The ostream operator<< defined in PObject 
is overridden by like-named procedures in PPoint and PLine. (See Pro- 
gram 10.4 line 42 and Program 10.5 lines 51-58.) 


With these explanations in place, we now give the header and code files for the 
class PObject. 


Program 10.4: Header file for the PObject class (version 1). 


#ifndef POBJECT H 
#define POBJECT_H 


#include <iostream> 
using namespace std; 


class PObject { 
private: 
double x,y,z; 
void scale(); 
double dot(const PObject& that) const; 


protected: 
bool equals(const PObject& that) const; 
bool less(const PObject& that) const; 
bool incident(const PObject& that) const; 
PObject rand_perp() const; 
PObject op(const PObject& that) const; 


public: 
PObject() { 
x =y = 0.; 
z=1.; 


} 
PObject(double a, double b, double c) { 


x= ay 
Y Seb; 
Z= Cc} 
scale(); 


} 


void randomize(); 


double getX() const { return x; } 
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double getY() const { return y; } 
double getZ() const { return z; } 


bool is_invalid() const { 
return (x==0.) && (y==0.) && (z==0.); 
} 
hi 


ostream& operator<<(ostream& os, const PObjecté& A); 


bool dependent(const PObject& A, const PObject& B, const PObject& C); 


#endif 


Program 10.5: Program file for the PObject class (version 1). 


#include "PObject.h" 
#include "uniform.h" 


void PObject::scale() { 
gf (2 J] On) 4% 
x /= 23 
y /= 2; 
z=41.; 
return; 
} 
ae (7 NE Oy) 4 
ae = S75 
7 = dog 
return; 
} 
alse (> (EO) of 
Soa ay 
} 
} 


double PObject::dot(const PObject& that) const { 


return xxthat.x + yxthat.y + zxthat.z; 


} 


void PObject::randomize() { 
do { 
x= -1., 
y unif(-1., 
z = unif(-1.,1.); 
Pe Nppoleiikey (Sieg Ge AYA GP Acid 22 la) P 
scale(); 


} 


I 
c 
i=] 
B- 
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1.); 
1.); 


bool PObject::equals(const PObject& that) const { 
return ( (x==that.x) && (y==that.y) && (z==that.z) 


} 


bool PObject::less(const PObject& that) const { 


if (x < that.x) return true; 
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return 
return 
return 
return 


return false; 
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false; 
true; 
false; 
true; 


bool PObject::incident(const PObject& that) const { 
return dot(that)==0.; 


} 


ostream& operator<<(ostreamé& os, 


os << 
<< 
<< 
<< 
<< 


nen 
A.getxX() << "," 
A.gety() << "," 
A.getZ() 

">", 


return os; 


} 


bool dependent(const PObject& A, 


double 
double 
double 


double 
double 
double 
double 
double 
double 


double 


return 


al = A.getX(); 
a2 = A.getY(); 
a3 = A.getZ(); 
bl = B.getX(); 
b2 = B.getY(); 
b3 = B.getZ(); 
cl = C.getX(); 
c2 = C.getY(); 
c3 = C.getZ(); 
det = alxb2«c3 

- a3xb2x«cl 
det == 0.; 


ap We so)s)- yolk 
- alxb3xc2 


als Dil c2, 
- a2xblxc3; 


PObject PObject::rand_perp() const { 
if (is_invalid()) return PObject(0,0,0); 


double x1,y1,z21; 
double x2,y2,22; 


// One vector orthogonal 
// Another orthogonal to 


if (z == 0.) { // If z==0, take (0,0,1) for 


xl = 


yle= 
rail 


} 


else { 


ae (7 == Os) vt 
xl = 


yl 
z1 


0; 
0; 
1 


1 


0: 
1: 
1 


i 
1 
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const PObject& A) { 


to (x,y,Z) 
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const PObject& B, const PObject& C){ 


(=,y,2) and (x1,y1,21) 


(x1,yl,y2) 


(0,1,0) 
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lse { // y and z both nonzero, use (0,-z,y) 
xl = 0; 
Syl = ep 
Zr 


normalize (xl,yl,z1) 


ble £1 = sqrt(xl«xxl + yl*xyl + zlxzl); 
/= x1; 
/= xr1; 
/= x1; 


(get x2,y2,z2) by cross product with (x,y,z) and (xl,yl,z1) 
= -(yl*z) + yxzl1; 

= xX1l*z - x*zl1; 

= -(xlxy) + xxyl; 


normalize (x2,y2,z2) 


ble r2 = sqrt(x2*x2 + y2«*y2 + 22*z2); 
/= 12; 
/= x2; 
/= x2; 


get a point uniformly on the unit circle 
ble a,b,xr; 

{ 

= unif(-1.,1. 
unif(-1.,1. 
= axa + bxb; 
inabikey (ag S> al, )}e 
sqrt(r); 
= ren 


); 
); 


ble xx = xl *« a + x2 x b; 
ble yy Nal El ap Vs ee Je)p 
ble zz = zl x a+ 22 x b; 


urn PObject(xx,yy,2Z); 


PObject PObject::op(const PObject& that) const { 


(equals(that)) return PObject(0,0,0); 


ble cl = yxthat.z - zxthat.y; 
ble c2 = zxthat.x - xxthat.z; 
ble c3 = xxthat.y - yxthat.x; 


Wen PObject (el, c2,c3)- 
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10.7. The classes PPoint and PLine 


With the code for PObject in place, we are ready to finish our work by writing the 
files for the classes PPoint and PLine. We do this work in four files: PPoint.h, 
PPoint.cc, PLine.h, and PLine.cc (Programs 10.6 through 10.9). 

AS we Start to write these files, we meet a chicken-and-egg problem. Which do 
we define first: the class PPoint or the class PLine? For us, this is more than 
a philosophical conundrum. Some PLine methods need to refer to PPoints. For 
example, operator acts on lines to produce points and PLine’s rand_point 
method returns a PPoint. Dually, some of the PPoint methods require the PLine 
class. 

Here is how we solve this dilemma. In the PPoint.h file, before we give the 
definition of PPoint we have the following statement (see line 6 of Program 10.6), 


class PLine; 


This lets the C++ compiler know that a class named PLine is defined somewhere 
else. Therefore, when the compiler sees PLine, it knows that this identifier refers 
to some class. However, it does not know anything else about PLine other than the 
fact it is a class. This means that we may not give an inline definition for any method 
that refers to objects of type PLine. Later, in the file PPoint.cc, we include all 
the headers (conveniently with the single directive #include "Projective.h"). 
Therefore, the code in PPoint.cc can make full use of the PLine class. 
Dually, we include the statement class PPoint; in the file PLhine.h. 


We focus our attention on the class PPoint. The analysis of PLine is similar. 

For the class PPoint we have five constructors. At first, this may seem to be too 
many, but we show how to do this easily. 

Of course, we want a three-argument constructor PPoint(a,b,c) that creates 
the point (a,b,c). We also want a zero-argument constructor PPoint () that creates 
the point (0,0, 1) corresponding to the origin. 

It makes sense to define a two-argument constructor PPoint(a,b) to create the 
point (a,b,1). In a sense, this maps the Euclidean point (a,b) to its natural corre- 
spondent in the RP?. 

What should be the action of a single-argument constructor? The real number a 
can be identified with the point (a,0) on the x-axis, and this in turn corresponds to 
(a,0,1) in RP?. In summary, we have the following constructors and their effects. 


Constructor form Point created 


PPoint P(); 
PPoint P(a); 


PPoint P(a,b); 
PPoint P(a,b,c); 





The great news is that we can implement these four constructors with a single 
definition using default parameters. 
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For any C++ procedure (class method or free-standing procedure), default values 
can be specified. In the .h file, where procedures are declared, we use a syntax such 
as this: 


return_type procedure _name(type argl = vall, type arg2 = val2, ...); 


Then, when the procedure is used, any missing parameters are replaced by their de- 
fault values. Let’s look at a concrete example. We declare a procedure named next 
that produces the next integer after a given integer. (This is a contrived example, but 
we want to keep things simple.) In the header file we put the following, 


int next(int num, int step=1); 


And in the .cc file, we have the code, 


int next(int num, int step) { 
return num+step; 


} 


Notice that the argument step is given a default value, 1. However, the argument 
num is not given a default. It is permissible to specify only a subset of the arguments 
that receive default values, but if an argument has a default value, all arguments to 
its right must also have default values. 

Notice that the optional arguments are not reiterated in the .cc file. 

Consider the following code. 
int a,b,c; 
next(5); 


next(5,1); 
next(5,2); 


ao om 
oil 


This will set a and b equal to 6 and c equal to 7. 
Alternatively, we could have given an inline definition of next in the header file 
like this: 


inline int next(int num, int step=1) { return num+step; } 


Returning to PPoint, the four constructors (with zero to three double arguments) 
can all be declared at once like this: 


PPoint(double a=0., double b=0., double c=1.) ...... 


See line 10 of Program 10.6. The action of this constructor is simply to pass the 
three arguments up to its parent (line 11) and then there is nothing else to do. To 
show there is nothing else, we give a pair of open/close braces that enclose empty 
space (line 12). 


The class PPoint needs one more constructor. Recall that Pobject provides 
methods such as rand_perp and op that return PObjects. However, when these are 
used by PPoint or PLine, the PObject values need to be converted to type PPoint 
or PLine as appropriate. To do this PPoint provides a constructor that accepts a 
single argument of type PObject. Here is the simple code (see also lines 14—15 of 
Program 10.6). 
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PPoint(const PObject& that) 
PObject(that.getX(), that.getY(), that.getZ()) { } 


This code sends the x, y, and z values held in that up to the parent constructor and 
then does nothing else. Now, if we want to assign a PObject value to a PPoint 
object, we can do it in the following ways. 


PObject X(2.,3.,5.); 
PPoint P(X); // invoke the constructor at declaration of P 


PPoint Q; 
Q = PPoint(X); // invoke the constructor as a converter procedure 


PPoint R; 
R= X; // implicit conversion (compiler figures out what to do) 


Here is the PPoint.h header file. 


Program 10.6: Header file for the PPoint class. 
#ifndef PPOINT_H 
#define PPOINT_H 
#include "PObject.h" 


class PLine; 


class PPoint : public PObject { 
public: 
PPoint(double a = 0., double b = 0., double c = 1.) : 
PObject(a,b,c) 
bd 


PPoint(const PObject& that) : 
PObject(that.getX(), that.getY(), that.getZ()) { } 


bool operator==(const PPoint& that) const { 
return equals(that); 


} 


bool operator!=(const PPoint& that) const { 
return !equals(that); 


} 


bool operator<(const PPoint& that) const { 
return less(that); 


} 


PLine operator+(const PPoint& that) const; 
bool is_on(const PLine& that) const; 


PLine rand_line() const; 


hi 


36 
37 
38 
39 
40 
Al 
42 
43 
44 


wn = 


wWNrF COCO ANADA UA 





aoaranannmn st 


wn 


aernranst 


198 C++ for Mathematicians 


ostream& operator<<(ostream& os, const PPoint& P); 


inline bool 

collinear(const PPoint& A, const PPoint& B, const PPoint& C) { 
return dependent(A,B,C); 

} 


#endif 


On lines 17-26 we give inline definitions of operator==, operator!=, and 
operator<. However, operator+, is_on, and rand_line may not be given in- 
line because these refer to the (as yet) unknown class PLine. (See lines 29-33.) 

The collinear procedure simply invokes the dependent procedure defined in 
PObject.h, so we give it inline here. The inline keyword in mandatory here 
because collinear is not a member of any class. 

The parts of PPoint not given in PPoint.h are defined in PPoint.cc which we 
present next. 


Program 10.7: Program file for the PPoint class. 


#include "Projective.h" 


ostream& operator<<(ostream& os, const PPoint& P) { 
Oe BS PY SS Doeaiex()) << Vp) SS Woes) =e U7 Ss Pecan) —< 7)" 
return os; 


} 


PLine PPoint::operator+(const PPoint& that) const { 
return PLine(op(that) ); 
} 


PLine PPoint::rand_line() const { 
return PLine(rand_perp()); 


} 


bool PPoint::is_on(const PLine& that) const { 
return incident(that) ; 


} 


The code for the class PLine is extremely similar to that of PPoint. Here are the 
files PLine.h and PLine.cc for your perusal. 


Program 10.8: Header file for the PLine class. 


#ifndef PLINE H 
#define PLINE_H 


#include "PObject.h" 
class PPoint; 


class PLine : public PObject { 
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9 public: 

0 PLine(double a = 0., double b = 0., double c = 1.) : 
1 PObject(a,b,c) 

2 ty 

3 

4 PLine(const PObject& that) : 

5 PObject(that.getX(), that.getY(), that.getZ()) { } 
6 

7 bool operator==(const PLine& that) const { 

8 return equals(that); 

9 } 

20 

21 bool operator!=(const PLine& that) const { 

22 return !equals(that); 

23 } 

24 

25 bool operator<(const PLine& that) const { 

26 return less(that); 

27 } 

28 

29 PPoint operators(const PLine& that) const; 

30 

31 bool has(const PPoint& X) const; 

32 

33 PPoint rand_point() const; 

34 

35 ba 

36 

37 ostream& operator<<(ostream& os, const PLine& P); 
38 


39 inline bool 
40 concurrent(const PLine& A, const PLine& B, const PLine& C) { 


41 return dependent(A,B,C); 
42 } 

43 

44 #endif 


Program 10.9: Program file for the PLine class. 


#include "Projective.h" 


ostream& operator<<(ostream& os, const PLine& P) { 
4 OS SS UY SS PocGeen) << Vp" SS Doce) << 7" SS Pace) << "5 
5 return os; 


6 } 

7 

8 PPoint PLine::rand_point() const { 

9 return PPoint(rand_perp() ); 

10 } 

11 

12 PPoint PLine::operators*(const PLine& that) const { 
13 return PLine(op(that) ); 

14 } 


16 bool PLine::has(const PPointé& that) const { 
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return incident(that); 


} 


10.8 Discovering and repairing a bug 


With the projective point and line classes built, it is time to test our code. Here is 


a simple main to perform some checks. 


Program 10.10: A main to test the RP? classes. 


#include <iostream> 
#include "Projective.h" 
#include "uniform.h" 


int main() { 
seed(); 


PPoint P; 


P.randomize(); 
cout << "The random point P is " << P << endl; 


PLine L,M; 


L P.rand_ line(); 
M = P.rand_line(); 


cout << "Two lines through P are L = " << L << endl 
<< "and M = " << M << endl; 


cout << "Is P on L? " << P.is on(L) << endl; 
cout << "Does M have P? " << M.has(P) << endl; 


PPoint Q; 
Q = LxM; 


cout << "The point of intersection of L and M is Q = 


cout << "Is Q on L? " << Q.is_on(L) << endl; 
cout << "Does M have Q? " << M.has(Q) << endl; 


if (P==Q) { 
cout << "P and Q are equal" << endl; 


} 
else { 
cout << "P and Q are NOT equal" << endl; 


} 


return 0; 


OM << 


endl; 
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When this program is run, we have the following output: 


The random point P is (-1.32445,0.591751,1) 

Two lines through P are L = [6.51303,12.8875,1] 
and M = [0.871229,0.260071,1] 

Is P on L? 0 

Does M have P? 0 


The point of intersection of L and M is Q = (-1.32445,0.591751,1) 
Is Q on L? 0 

Does M have Q? 0 

P and Q are NOT equal 





Much of what we see here doesn’t make sense. First, the lines L and M are random 
lines through P. Yet the output indicates that P is on neither of these lines. Then, 
we generate the point Q at the intersection of L and M. The good news is that the 
coordinates of P and Q are the same: (—5.64488, 2.562, 1). However, the computer 
still tells us that Q is on neither L nor M. Worse, it thinks that P 4 Q. What is going 
on here! ? 


All these problems stem from the same underlying cause: roundoff. Remember 
that a double variable is a rational approximation to a real number. Two real quanti- 
ties that are computed differently may result in double values that are different. For 
example, consider this code: 


#include <iostream> 
using namespace std; 
int main() { 
double x = 193./191.; 
double y = 1./191.; 
y «= 193; 
if (x == y) { 
cout << "They are equal" << endl; 


} 
else { 
cout << "They are different" << endl; 
cout << "Difference = " << x-y << endl; 
} 
return 0; 


} 
Here is the output from this program. 


They are different 
Difference = -2.22045e-16 


The computer reports that tor F 193 x ior 

The equality test we created for PObjects checks if the three coordinates are 
exactly the same. We need to relax this. 

The bad news is we need to rewrite some of our code to correct this problem. The 
great news is that we only need to repair PObject. The children PPoint and PLine 


inherit the improvements. 
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To begin, let us identify the places in the code for PObject where exact equality 
is sought. 


e The equals method requires exact equality of the three coordinates. 


e The incident method requires zero to be the exact result of the dot product 
method. 


e The dependent procedure requires zero to be the exact value of the determi- 
nant. 


In lieu of exact equality, we can require that the values be within a small tolerance. 
What tolerance should we use? We make that quantity user selectable initialized with 
some default value (say 107!2), 

To implement this idea we add a private static double variable named tolerance 
and define a constant named default_tolerance set to 107 |”. 

Inside PObject we define two inline public static methods: set_tolerance and 
get_tolerance. Here is the revised header file. 


Program 10.11: Header file for the PObject class (version 2). 


#ifndef POBJECT _H 
#define POBJECT_H 
#include <cmath> 
#include <iostream> 
using namespace std; 


const double default tolerance — le-12; 


class PObject { 
private: 
double x,y,z; 
void scale(); 
double dot(const PObject& that) const; 
static double tolerance; 


protected: 
bool equals(const PObject& that) const; 
bool less(const PObject& that) const; 
bool incident(const PObject& that) const; 
PObject rand_perp() const; 
PObject op(const PObject& that) const; 


public: 
PObject() { 
x=y = 0.; 
Zo—) ll 


} 
PObject(double a, double b, double c) { 


xX =a; 
MY = 19) 
Z= Cc; 


scale(); 
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void randomize(); 


static void set_tolerance(double t) { 
tolerance = abs(t); 


} 


static double get_tolerance() { 
return tolerance; 


} 


double getX() const { return x; } 
double getY() const { return y; } 
double getZ() const { return z; } 


bool is_invalid() const { 
return (x==0.) && (y==0.) && (z==0.); 
} 


hi 
ostream& operator<<(ostream& os, const PObjecté& A); 
bool dependent(const PObject& A, const PObject& B, const PObjecté& C); 


#endif 


Inside PObject.cc we need to declare PObject: : tolerance and we give it an 
initial value. (See Program 10.12, line 4.) 

We also need to modify the equals, incident, and dependent procedures to 
test for near equality instead of exact equality. You can find these modifications on 
lines 37—39, 52, and 80 of the new PObject.cc file which we present here. 


Program 10.12: Program file for the PObject class (version 2). 


#include "PObject.h" 
#include "uniform.h" 


double PObject::tolerance = default_tolerance; 


void PObject::scale() { 

ne (4 1] Oo) 4 
ve [= 640 
y /= 2; 
z=1.; 
return; 

} 

ae (7 Ee Wn )) 4 
x /= yi 
yu l.; 
return; 

} 

aie ((< (l= 0) if 
og Gt hsp 


} 
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21 +} 

22 

23. double PObject::dot(const PObject& that) const { 
24 return xxthat.x + yxthat.y + zxthat.z; 
25 } 

26 

27 void PObject::randomize() { 

28 do { 

29 x = unif(-1.,1.); 

30 y = unif(-1.,1.); 

31 Z = unit(-1.,1.)% 

32 Je Aides, ((SgS5ko Ge SAY ae vases SS LG NP 

33 scale(); 

34} 

35 


36 bool PObject::equals(const PObject& that) const { 
37 double d = abs(x-that.x) + abs(y-that.y) + abs(z-that.z); 


39 return d <= tolerance; 


} 


0 
1 
42 bool PObject::less(const PObject& that) const { 
3 if (x < that.x) return true; 





44 if (x > that.x) return false; 

45 af (y < that.y) return true; 

46 if (y > that.y) return false; 

47 if (z < that.z) return true; 

48 return false; 

49 } 

50 

51 bool PObject::incident(const PObject& that) const { 
52 return abs(dot(that)) <= tolerance; 
53. } 

54 


55 ostream& operator<<(ostream& os, const PObject& A) { 
56 OS 


57 << A.getx() << "," 
58 << PAR ete Yi (0) << 
59 << A.getZ() 

60 cae 

6l return os; 

62 +} 

63 


64 bool dependent(const PObject& A, const PObject& B, const PObjecté& C) { 


65 double al = A.getX(); 
66 double a2 = A.getY(); 
67 double a3 = A.getZ(); 
68 

69 double bl = B.getxX(); 


70 double b2 = B.getY(); 


71 double b3 = B.getZ(); 
72 

73 double cl = C.getX(); 
74 double c2 = C.getY(); 
75 double c3 = C.getZ(); 
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double det = alxb2s*c3 + a2*b3*cl + a3xblxc2 


- a3xb2«*cl - alxb3*«c2 - a2«blxc3; 


return abs(det) <= PObject::get_tolerance(); 


} 


PObject PObject::rand_perp() const { 
if (is_invalid()) return PObject(0,0,0); 


double xl,y1,zi; 
double x2,y2,22; 


if (z == 0.) { // If z==0, take (0,0,1) for (x1,yl,y2) 
xl = 


(y == 0.) { // z != 0 and y == 0, use (0,1,0) 


else { // y and z both nonzero, use (0,-z,y) 


tL = (08 
iL = =e 
l= y; 


// normalize (x1,y1,z21) 
double rl = sqrt(xl*exl + yleyl + zlszl); 


ll /= res 
yl /= rl; 
vail, /= geile 


// (get x2,y2,z2) by cross-product with (x,y,z) and (xl,y1,z1) 


x2 = 


y2 = 
zZ2 


-(yl*z) + yxzl; 
X1l*zZ - x*z1; 
-(xl«*y) + xxyl; 


// normalize (x2,y2,z22) 
double r2 = sqrt(x2*x2 + y2*y2 + z22%z2); 


se fS 18Oe 
y2 /= x2; 
4 |= 1eAp 


// get a point uniformly on the unit circle 
double a,b,r; 


do { 
a 
b 
5g 


uniit=1.,1. )¢ 
wuNdived. 2. hs 
axa + bxb; 


We Aisolanihey (fre 25 al, yp 


ie S 


s 


qrt(r); 


a /=143 


// One vector orthogonal to (x,y,Z) 
// Another orthogonal to (x,y,z) and (x1l,yl1,z1) 
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b /= x; 

double xx = xl *« a + x2 « b; 
double yy = yl * a + y2 * b; 
double zz = zl *« a+ 22 x b; 


return PObject(xx,yy,2Z); 


PObject PObject::op(const PObject& that) const { 


if (equals(that)) return PObject(0,0,0); 


double cl yethat.z - zxthat.y; 
double c2 zxthat.x -— xxthat.z; 
double c3 = xxthat.y - yxthat.x; 


return PObject(cl,c2,c3); 


When the test program (Program 10.10) is run with the new PObject class, we 
achieve the desired results. 


The random point P is (-0.479902,-0.616199,1) 
Two lines through P are L = [0.384191,1.32364,1] 
and M = [1.66531,0.32589,1] 

Is P on L? 1 

Does M have P? 1 


The point of intersection of L and M is Q = (-0.479902,-0.616199,1) 
Is Q on L? 1 

Does M have Q? 1 

P and Q are equal 





The user may invoke PObject: :set_tolerance(0.0) ; to revert to the previ- 
ous behavior (exact checking). 


Finally, the method we use for testing near equality can be improved. For example, 
we check if two projective objects are equal by computing their L' distance and 
comparing against tolerance. Alternatively, to check (x1,y1,z1) and (x2,y2,z2) 
for equality, we might consider a test such as this: 


|x1 — x2| + |y1 — yo] + |z1 — z2| Z 
lx1| + [xo] + Lyi] + lye] + lea] [za] ~~ 


Whatever equality test you feel is most appropriate, it is only necessary to edit one 
method (equals in PObject) to implement your choice. 
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10.9 Pappus revisited 


We close this section with a program to illustrate Pappus’s Theorems and the use 
of the near-equality testing. 


Program 10.13: A program to illustrate Pappus’s theorem and its dual. 


#include "Projective.h" 
#include "uniform.h" 


lx 
x An illustration of Pappus’s theorem and its dual 
«/ 


void pappus() { 
seed(); 


// two random lines 

PLine L1,L2; 
L1.randomize(); 
L2.randomize(); 

cout << "The two lines are " << endl << Ll << " and " << L2 << endl; 
// get three points on the first 

PPoint Pl = Ll.rand_point(); 

PPoint P2 = Ll.rand_point(); 

PPoint P3 = Ll.rand_point(); 


cout << "Three points on the first line are " << endl 
<< Pl << endl << P2 << endl << P3 << endl; 


// get three points on the second 
PPoint Q1 = L2.rand_point(); 
PPoint Q2 = L2.rand_point(); 
PPoint Q3 = L2.rand_point(); 


cout << "Three points on the second line are " << endl 
<< Q1 << endl << Q2 << endl << Q3 << endl; 


// find the three pairwise intersections 
PPoint X1 = (P2+Q3)«(P3+Q2); 
PPoint X2 (P14+Q3) «(P3+Q1); 
PPoint X3 = (P1+Q2)«(P2+Q1); 


cout << "The three points constructed are " << endl; 
cout << X1 << endl << X2 << endl << X3 << endl; 


if (collinear(X1,X2,X3)) { 
cout << "They are collinear, as guaranteed by Pappus’s theorem" 
<< endl; 
} 
else { 
cout << "TROUBLE! The three points are not collinear!!" 
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<< endl; 


void dual_pappus() { 


// Two random points 

PPoint A,B; 

A.randomize(); 

B.randomize(); 

cout << "The two points are " << endl << A << " and " << B << endl; 


// Three lines through the first 
PLine Ll = A.rand_line(); 
PLine L2 = A.rand_line(); 
PLine L3 = A.rand_line(); 


cout << "The three lines through the first point are " << endl 
<< Ll << endl << L2 << endl << L3 << endl; 


// Three lines through the second 
PLine Ml = B.rand_line(); 
PLine M2 = B.rand_line(); 
PLine M3 = B.rand_line(); 


cout << "The three lines through the second point are " << endl 
<< Ml << endl << M2 << endl << M3 << endl; 


// Get the three dual Pappus lines 
PLine X1 = L2«M3 + L3«M2; 
PLine X2 = L1*«M3 + L3*M1; 
PLine X3 = L1l«M2 + L2«M1; 


cout << "The three lines constructed are " << endl; 
cout << X1 << endl << X2 << endl << X3 << endl; 


if (concurrent(X1,X2,X3)) { 
cout << "They are concurrent, as guaranteed by Pappus’s theorem' 
<< endl; 


} 
else { 
cout << "TROUBLE! The three lines are not concurrent!!" 
<< endl; 


int main() { 


double t; 

cout << "Enter desired tolerance --> "; 

Cin e=>oty 

PObject::set_tolerance(t); 

cout << "You set the tolerance to " << PObject::get_tolerance( ) 
<< endl << endl; 


pappus(); 
cout << endl; 
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dual_pappus(); 


return 0; 


Here are three runs of the program with the tolerance set to different values. 


Enter desired tolerance --> 0 
You set the tolerance to 0 


The two lines are 

[2.23943,2.19462,1] and [-0.685646,2.15228,1] 
Three points on the first line are 
(14.3273,-15.0755,1) 

(-0.434872,-0.0119093,1) 

(-0.56911,0.12507,1) 

Three points on the second line are 
(-2.29319,-1.19516,1) 

(0.43878,-0.324843,1) 

(7.8271,2.02884,1) 

The three points constructed are 
(-0.323743,0.01554,1) 

(6.49488,5.53439,1) 

(-0.0728833,0.218581,1) 

TROUBLE! The three points are not collinear!! 


The two points are 

(0.576837,0.361625,1) and (-0.407185,0.0903103,1) 
The three lines through the first point are 
[-1.45089,-0.450946,1] 

[0.398283,-3.4006,1] 

[18.9351,-32.9691,1] 

The three lines through the second point are 
[2.2305,-1.01622,1] 

[2.46456,0.0391258,1] 

[2.51677,0.274485,1] 

The three lines constructed are 
[2.42584,0.116742,1] 

[1.63958,0.114103,1] 

[3.10284,0.119014,1] 

TROUBLE! The three lines are not concurrent!! 


Enter desired tolerance --> le-16 
You set the tolerance to le-16 


The two lines are 
[0.55364,0.547428,1] and [1.05044,-0.347064,1] 
Three points on the first line are 
(-0.0325509,-1.79381,1) 
(-0.440495,-1.38123,1) 
(1.76843,-3.61523,1) 

Three points on the second line are 
(-2.34784,-4.22478,1) 
(-0.911666,0.122021,1) 
(-0.367147,1.77009,1) 

The three points constructed are 
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(-0.421418,-0.561603,1) 

(0.160804,-3.85329,1) 

(-0.310677,-1.18769,1) 

They are collinear, as guaranteed by Pappus’s theorem 


The two points are 

(-15.284,42.4406,1) and (-2.5346,1.29455,1) 
The three lines through the first point are 
[-1.32801,-0.501814,1] 
[-0.903241,-0.348843,1] 
[0.00499314,-0.0217642,1] 

The three lines through the second point are 
[2.56928,4.25793,1] 

[0.38109,-0.0263314,1] 

[31.5203,60.9412,1] 

The three lines constructed 
[-0.725517,-0.0128931,1] 
[-9.98448,-16.6938,1] 
[-0.936431,-0.392874,1] 

TROUBLE! The three lines are not concurrent!! 


Enter desired tolerance --> le-12 
You set the tolerance to le-12 


The two lines are 

[0.52502,-0.458764,1] and [-0.330266,1.96863,1] 
Three points on the first line are 
(-2.99912,-1.25249,1) 

(-1.44265,0.528772,1) 

(-2.39671,-0.563076,1) 

Three points on the second line are 
(1.18674,-0.308875,1) 

(1.38413,-0.27576,1) 

(-6.11116,-1.53321,1) 

The three points constructed are 
(-4.23015,-0.702403,1) 

(30.568,1.77536,1) 

(1.20682,-0.315271,1) 

They are collinear, as guaranteed by Pappus’s theorem 


The two points are 

(15.562,5.35536,1) and (-0.432665,0.837712,1) 
The three lines through the first point are 
[-0.171104,0.310479,1] 

[-2.21649,6.25412,1] 

[-0.915338,2.47313,1] 

The three lines through the second point are 
[-3.3276,-2.91238,1] 

[0.807493,-0.776671,1] 

[-9.38979,-6.0434,1] 

The three lines constructed are 
[-2.58492,5.62249,1] 

[-2.64901,-1.39739,1] 

[-2.6087,3.01846,1] 

They are concurrent, as guaranteed by Pappus’s theorem 
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10.10 Exercises 


10.1 


10.2 


Create a pair of classes named Rectangle and Square, which should be a 
derived subclass of Rectangle. 


Rectangle should have two data members (representing the height and width) 
and the following methods. 


e A two-argument constructor. 
e Methods to get the height and width. 
e Methods to change the height and width. 


e Methods to report the area and perimeter. 


Square should have a single-argument constructor (which should rely on 
Rectangle’s constructor). It should have the same methods as Rectangle, 
except that the methods to change height and width should modify both the 
height and width. 


Create a class called Parallelogram that represents a parallelogram seated 
in the plane as shown in the figure. 


(b,c) 


(a,0) 


The values a and c must be nonnegative; b may be any real value. 


The Parallelogram should define a zero- and three-argument constructor 
and methods for computing the area and perimeter of the figure. 


Next, create two subclasses named Rectangle and Rhombus from the par- 
ent class Parallelogram. Define appropriate two-argument constructors for 
these subclasses. 


There is no need to make a new area() method for the subclasses; the par- 
ent’s area() method is efficient and serves the subclasses well. However, the 
perimeter() method in the Parallelogram needs to invoke the sqrt pro- 
cedure to find the side length from (0,0) to (b,c). However, the subclasses can 
find the perimeter in a more efficient manner. So, although it isn’t necessary to 
redefine perimeter() for Rhombus and Rectangle, do so anyway so these 
procedures are more efficient in the special cases. 
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10.3 


10.4 


10.5 


10.6 


10.7 
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In Exercise 8.3 we explored C++’s inability to hold complex<doub1le> values 
in a set container because the complex<double> type does not define a < 
operator. We resolved that issue by making a set of pair<double, double> 
objects that held the values (x,y) in lieu of x + yi. 


Create an alternative solution by creating a class named mycomp1ex that is de- 
rived from the complex<double> type. Add to mycomplex an operator<. 
You also need zero-, one-, and two-argument constructors (with double argu- 
ments); these should invoke complex<double>’s constructors. 


Finally, write a short main( ) procedure to check that mycomplex objects can 
be housed in a set<mycomplex> container. 


Define a pair of classes named Point and Segment to represent points and 
line segments in the plane. The Point class should include an operator+ 
method; the result of P+Q is the line segment joining the points. The Segment 
class should include a midpoint() method that returns the Point that is 
midway between the end points of the line segment. 


For both classes, define operator<< for writing to the screen. 
In C++ it is possible to have two classes, Alpha and Beta, such that arguments 
and return values for methods in one class may be the type of the other class. 


That is, an Alpha method might return a Beta value and vice versa. (This is 
the case for the Point and Segment classes in Exercise 10.4.) 


Can we create classes Alpha and Beta so that each contains data members 
that are of the other type? 


Extend the complex<doub1e> class to include the value % (complex infinity) 
by creating a derived class named Complexx. This new value should interact 
with finite complex values in a sensible way. For example, 


c+ z7= 0 for finite z 
cx Oo 

z+0=0 forz 40 
zZ+a0=0 for finite z 


Some calculations with Complexx values should yield a special undefined 
value; for example, 0 +0, 26 + 00, 0 x 00, «0/00, and so on. 





Your class should include the operators +, - (unary and binary), *, /, ==, !=, 
and << (for writing to the screen). 


Use the PPoint and PLine classes to write a program to illustrate Desargues’ 
Theorem: suppose that triangles ABC and DEF are in perspective from a point 
O. (That is, the triples OAD, OBE, and OCF are each collinear.) Then the three 
points of intersection of the lines AC and DF, lines AB and DE, and lines BC 
and EF are collinear (see the points X, Y, and Z in Figure 10.4). 
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Figure 10.4: An illustration of Desargues’ Theorem. 
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Chapter 11 





Permutations 


Let n be a positive integer. A permutation is a one-to-one and onto function (i.e., a 
bijection) from the set {1,2,...,} to itself. The set of all permutations of this set is 
denoted S,. 

One way to represent a permutation 7 is as a list of values [7(1),2(2),..., 
For example, a = [1,4,7,2,5,3,6] means a € S7 and (1) = 1, 2(2) =4, x(3 
and so on, and 2(7) = 6. 

The disjoint cycle notation is an alternative way to write permutations. The permu- 
tation z = [1,4,7,2,5,3,6] is written (1)(2,4)(3,7,6,5). The (1) means a(1) = 1. 
The (2,4) means 2(2) = 4 and 2(4) = 2. The (3,7,6,5) means 2(3) = 7, 2(7) =6, 
(6) =5, and (5) =3. In other words, (1)(2,4)(3,7,6,5) means this: 

lrl 2412 3H TH 653. 

In this chapter we develop a C++ class to represent permutations. We have two 

goals. One is to introduce additional C++ concepts (copy constructors, destructors, 


and assignment operators). The other is to write a program to explore Ulam’s prob- 
lem. 





11.1. Ulam’s problem 


Given a permutation 2 € S,, we may regard 7 as a sequence [7(1),7(2),...,7(n)]. 
An increasing subsequence of @ is a sequence [z(i1),@(i2),...,@(i+)] where 1 < 
ip <ig <-++ <i, <n and A(i1) < Min) <--- < H(i). A decreasing subsequence 
is defined analogously. A subsequence of a permutation is called monotone if it is 
either increasing or decreasing. 

For example, the sequence [1,4,7,2,5,3,6] contains the increasing subsequence 
(1,2,3,6] and the decreasing subsequence [7,5,3]. Every permutation must have 
a “reasonably” long monotone subsequence. This is a consequence of the Erdés— 
Szekeres Theorem. 


Theorem 11.1 (Erd6és—Szekeres). Let k be a positive integer and letn = k* +1. Then 
every permutation 1 € S, contains a monotone subsequence of length k + 1. 


Informally, the result states that every permutation in S,, contains a monotone sub- 
sequence of length about \/n. The proof of this result is interesting both because it 
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is a good example of the use of the pigeonhole principle and because it leads to an 
algorithm for finding longest monotone subsequences of permutations. 


Proof. Let  € S, where n = k* +1. For each i with 1 <i <n let (u;,d;) denote 
the lengths of the longest increasing and decreasing subsequences of 7 that start at 
position i. For example, the sequence [1,4,7,2,5,3,6] gives the following values for 
Uj and dj. 
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The easiest way to verify this chart is to check the u; and d; entries starting from 
the right. 

The key observation is that for i # j we have (uj,d;) 4 (uj,dj). To see why, let 
i< j. Then either (i) < (j), in which case uj; > uj; or else 2(i) > 2(j), in which 
case d; > dj. 

Suppose, for the sake of contradiction, there is a permutation z in S, without a 
monotone subsequence of length k + 1 (where e+1= n). Therefore, 1 < uj,dj <k 
for all i. Hence there are at most k* distinct values of (u;,d;) and so for some pair 
of indices i # j we have (u;,d;) = (uj,d;). <= Therefore, 7 must have a monotone 
subsequence of length k+ 1. 














Ulam’s problem concerns the longest increasing subsequence of a random permu- 
tation. Suppose a permutation 7 is chosen uniformly at random from S,. That is, 
all permutations in S,, are equally likely, each with probability 1/n!. What is the 
expected length of z’s longest increasing subsequence? 

If we let L, be the random variable giving the length of a longest increasing sub- 
sequence in 7, then Ulam’s problem asks us to find E(L,). The Erdés—Szekeres 
Theorem suggests that this value should be on the order of \/n. Indeed, in a cele- 
brated paper, Hammersley! showed that 


E(L 
lim (Ln) 


n—-oo Jn 





exists (and is not zero). Subsequent work in papers by Logan and Shepp? and by 
Vershik and Kerov? establish the value of this limit. (We give the answer at the end 
of this chapter.) 


'J.M. Hammersley, A few seedlings of research, Proceedings of the Sixth Berkeley Symposium on Math- 
ematical Statistics and Probability, 1 (1972), 345-394. 

2B.F. Logan and L.A. Shepp, A variational problem for random Young tableaux, Advances in Math. 26 
(1977), 206-222. 

3 A.M. Vershik and S.V. Kerov, Asymptotics of the Plancherel measure of the symmetric group and the 
limiting form of Young tables, Soviet Math. Dokl., 18 (1977), 527-531. 
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11.2 Designing the Permutation class 


Here is the header file, Permutation.h for the Permutation class. The overall 
design of the class as well as the new C++ concepts are explained after. 





Program 11.1: Header file for Permut ation class, Permutation.h. 


#ifndef PERMUTATION_H 
#define PERMUTATION_H 
#include <iostream> 
using namespace std; 


class Permutation { 
private: 

k@xalsy ai 

longs data; 


porloyllak@ g 
Permutation (); 
Permutation(long nels); 
Permutation(long nels, long* array); 
Permutation(const Permutation& that); 
“Permutation (); 


void swap(long i, long 3); 

void randomize (); 

void reset (); 

bool check() const; 

long getN() const { return n; } 

jle@iate; ic (lLesiey Vs) eomsic? 

long operator() (long k) const { return of(k); } 


Permutation operator=(const Permutation& that); 


Permutation operator* (const Permutation& that) const; 
Permutation operator*=(const Permutationé that); 





Permutation inverse() const; 


bool operator==(const Permutation& that) const; 
bool operator!=(const Permutation& that) const; 
bool operator< (const Permutation& that) const; 
bool isIdentity() const; 

}; 


ostream& operator<<(ostream& os, const Permutationé& P); 


#endif 
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11.2.1 Data 


To represent an element of S,, we hold the integer n in a long variable. We also 
need a way to store the values 2(1) through 2(n). For that task we have two natural 
choices: an array of long values or a container such as vector<long> (see Sec- 
tion 8.4). Although using a vector container would simplify some issues, we opt 
for an array for the following reasons. First, once we create a permutation object, 
we do not expect the length (7) of the permutation to change. Therefore, we do not 
need a vector’s ability to resize itself. Second, using an array compels us to learn 
additional features of C++. 

The class Permutation contains two data elements in its private section such as 
this: 
class Permutation { 
private: 

long n; 

long* data; 
public: 


}; 


The integer n holds the size of the permutation; that is, the permutation is on the 
integers | through n. 

The array data holds the values z(i) for 1 <i <n. To make our lives easier, we 
let data[1] hold the value 2(1), data[2] hold 2(2), and so on. This means that 
we need to be sure that data has capacity n+1. The entry data[0] is wasted.* 

To be sure that a Permutation object is always valid, we do not give users un- 
fettered access to data. All of the methods that act on Permutation objects must 
ensure that n and data represent a valid permutation. 


11.2.2 Constructors and destructors 


The Permutation class contains four constructors. 


e The first is a basic, zero-argument constructor Permutation(). This con- 
structor creates the identity permutation (1) in S,. (See line 12 of Program 
11.1.) 


e The second is a single-argument constructor Permutation (nels). When 
nels is a positive integer n, this creates the identity permutation (1)(2)---(n) 
in S,. (See line 13.) 


e The third is a two-argument constructor Permutation (nels, array). Here, 
nels contains a positive integer n, and array contains an array of n+ 1 long 


4Note that we could use data[0] to store n obviating the need for the variable n. This would be efficient 
for the computer’s memory, but inefficient for human memory as this would require us to remember this 
trick. It would also make the code harder to understand. Avoid sneaky tricks. 


Permutations 219 


integers. The value of array[k] is m(k) for 1 <k<n. Thus array should 
be of size nelst+1. (See line 14.) 


The action of this constructor is to assign n from nels and to copy entries 1 
through nels of array into data. This, however, is dangerous. We do not 
know if the data held in array are a valid representation of a permutation. 
Therefore, we include a check method (line 22). The check method returns 
true if the data held in the Permutation are valid. If the check method 
returns false, the constructor calls reset to reset the permutation to the 
identity of Sy. 


See lines 20 and 22 of Permutation.h (Program 11.1) and lines 21-32, 44- 
46, and 65-85 of Permutation.cc (Program 11.2.) 


e The fourth is a single-argument constructor Permutation (that) where the 
argument that is also a Permutation object. This is called a copy construc- 
tor. The new permutation created is a copy of that. (See line 15.) 


Until this point, we have not needed a copy constructor. Its necessity is ex- 
plained shortly (Subsection 11.2.3). 


In all four cases, the private data elements, n and data, need to be initialized by 
the constructor. For example, here is the portion of the file Permutation.cc that 
spells out the action of the Permutation (nels) constructor (copied from lines 10- 
19 of Program 11.2). 


Permutation::Permutation(long nels) { 
if (nels <= 0) { 
nels = 1; 
} 


data = new long[nels+1]; 


n = nels; 
for (long k=1; k<=n; k++) { 
data[k] = k; 


} 
} 


Remember that data is of type long» (an array of long values). Until memory has 
been allocated for data, we cannot store values in data[1], data[2], and so on. 
The allocation of storage takes place with data = new long[nelst1];. Once 
the storage has been allocated, the data array can be populated (see the for loop). 

This code appears to violate our admonition that every new must be balanced with 
a corresponding delete[]. Where is the delete[] statement? 

We cannot add the statement delete[] data; to the constructor. If we do, no 
sooner do we set up data then we would destroy it, defeating the purpose of the 
constructor. 

What we need is for the delete[] instruction to execute when we are done with 
the object. For example, consider this bit of code. 
void example(long n) { 


Permutation P(n); // make a new permutation 
// do a bunch of stuff 
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cout << P << endl; // print P 
} 


When the procedure examp1e is invoked, a Permutation object P is created. When 
the procedure reaches its end, the variable P goes out of scope and is no longer 
available. If example were called repeatedly (say, by main), then we would have 
repeated new statements without any balancing deletes. This is a memory leak. On 
each invocation, a new block of memory is allocated but never released for reuse. 

The solution to this problem is to create a destructor. A destructor is a method 
that the computer automatically invokes when a variable goes out of scope, typically 
at the end of a procedure in which it was declared. 

Destructors are named as follows. The first character is a tilde and the remainder 
of the name is the name of the class: ~Permutation in the current case. When 
declaring a destructor, no return type is specified and the argument list is empty. 
Here is line 16 of Permutation.h (Program 11.1). 


~Permutation(); 


The code for ~Permutation() is on lines 40-42 of Permutation.cc (see Pro- 
gram 11.2); we repeat that code here. 


Permutation::~Permutation() { 
delete[] data; 
} 


Alternatively, we could have defined ~Permut ation inline in the header file in the 
public section of the Permutation class like this: 


~“Permutation() { delete[] data; } 


With this destructor in place, the memory leak in the example procedure has been 
repaired. Every time the computer reaches the end of examp1e, the variable P goes 
out of scope. At that point, the destructor is executed. If you wish, you may add a 
statement such as cerr << "Destructor ran" << endl; to ~Permutation’s 
code; this enables you to observe the destructor when it runs. 

Classes that do not dynamically allocate memory do not require destructors. The 
container classes (discussed in Chapter 8) have destructors; any memory they con- 
sume is freed when their variables go out of scope. 


11.2.3 Copy and assign 


If a and b are long integers, the statement a=b; puts a copy of the value held in 
b into a. Later, if we modify b there is no effect on a. Furthermore, the expression 
a=b returns a value: the common value held in b and now a. The statement a=b=c; 
is tantamount to a= (b=c) ;. The expression b=c is evaluated first. The value of the 
expression b=c is the value held in c (and now b). That value is then assigned to a. 
In this way, the single statement a=b=c; is equivalent to the pair of statements b=c; 
and a=b;. In summary, the statement a=b; has an action (giving a a copy of the 
value held in b) and a value (the now common value held in a and b). 
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If a and b are objects of a class, then the assignment operator a=b; has a prede- 
fined, default meaning in C++. The action is to copy each data element in b to the 
corresponding data element in a. The value of a=b; is a copy of the common value 
held in a and b. 

For example, recall the Point class from Chapter 6. Objects of type Point con- 
tain two data elements: double variables x and y. (See Point.h, Program 6.1.) 
Therefore, the statement a=b; has the same effect as the two statements a. x=b.x; 
and a.y=b.y;. (Note: This pair of statements is illegal outside a Point method 
because the data elements x and y are private. However, the single statement a=b; 
is permissible anywhere.) The value of the statement a=b; is a copy of the value in 
b (and now a). Therefore, if a, b, and c are objects of type Point, the statement 
a=b=c; works just as do the pair of statements b=c; a=b;. 

When a variable is passed to a procedure, a copy of that variable is created. For 
example, when we invoke a procedure such as d=gcd (a,b), copies of a and b are 
created and sent to the gcd procedure. (However, if a procedure’s argument is set up 
for call by reference, then no copy is made and the function parameter is tied directly 
to the variable named in the corresponding position.) 

Similarly, if an argument to a procedure is of an object of a certain class, then a 
copy of that object is created and sent to the procedure. For example, the procedure 
midpoint (P,Q) works on copies of P and Q. These duplicates are tacitly created 
by copying the x and y fields of P and Q. 

These copies are made by a copy constructor. The default copy constructor simply 
replicates the data elements in the objects. It is possible to see these actions explicitly 
in the following program. 

#include "Point.h" 


#include <iostream> 
using namespace std; 


int main() { 
Point X(2,3); 
Point Y(X); 
Point 2Z; 
Z= Y; 
cout << X << endl; 
cout << Y << endl; 
cout << Z << endl; 
return 0; 


First, the object x is created with x. x equal to 2 and x. y equal to 3. This uses the 
standard two-argument constructor. 

Second, a copy of xX is created in y using the statement Point Y(X);. Notice that 
in Point .h there is no constructor with a single Point argument. C++ provides a 
default copy constructor. If we were to write code for the default copy constructor, it 
would look like this: 


Point (const Pointé& that) { 
x = that.x; 
y = that.y; 
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Third, we create a Point object Z using the zero-argument constructor. The state- 
ment Point 2Z; initializes z to the point (0,0). The next statement is 2 = y;. This 
invokes the default assignment operator. The action of the assignment operator is to 
copy the data elements of y to Z, and then return the (new) value of z as the result. 
If we were to write a program for the default assignment operator, it would look like 
this: 

Point operator=(const Pointé& that) { 

x = that.x; 

y = that.y; 


return «this; 


} 


The last statement, return *this;, returns a copy of the left-hand side of the 
assignment statement. 

For all of the classes previously considered in this book, the default copy con- 
structor and assignment operator work fine. Indeed, we did not even mention their 
existence because their actions were “obvious.” However, for the Permutation 
class, the default behaviors are not acceptable. 

Here is the problem. Suppose that P and Q are objects of type Permutation. The 
default action of P=Q; is equivalent to P.n=Q.n; P.data=Q.data;. The first part, 
P.n=Q.n; is fine, but the second part, P. data=Q.data; is problematic. Recall that 
the data field of the class Permut ation is of type long. Therefore, the statement 
P.data=Q.data; does not copy Q’s data to P. Instead, the effect is for P.data 
to refer to exactly the same block of memory as Q.data. That would cause any 
subsequent changes to one of P or Q to affect the other. This is not the behavior we 
want. The statement P=Q; ought to place an independent copy of the permutation Q 
into P. Because the default behavior does not suit us, we need to override the default 
by explicitly defining an assignment operator. 

In addition, the default copy constructor does not suit our purposes. Like the 
default assignment operator, the default copy constructor simply copies the data ele- 
ments. 

The default methods need to be replaced. In their stead, we declare the following 
methods in the public section of the Permutation class (see lines 15 and 28 of 
Permutation.h, Program 11.1), 


Permutation(const Permutationé& that); 
Permutation operator=(const Permutation& that); 


The code for these is given in Permutation.cc (Program 11.2). Let’s look at the 
code for each. 
The copy constructor code looks like this: 


Permutation::Permutation(const Permutation& that) { 
n = that.n; 
data = new long[nt+1]; 
for (long k=1; k<=n; k++) data[k] = that.data[k]; 
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Note that there is no return type because this is a constructor. The argument is a 
reference to aconstant Permutation named that. The first action is simply to copy 
that’s n value to the new n value; this is exactly what the default copy constructor 
would do. Now, instead of data=that .data;, we allocate a new block of memory 
for data and then perform an element-by-element copy of the entries in the array 
that.data to our data. 

The assignment operator acts in a similar manner. Here is the code. 
Permutation Permutation: :operator=(const Permutation& that) { 

delete[] data; 

n = that.n; 

data = new long[nt+1]; 

for (long k=1; k<=n; k++) data[k] = that.data[k]; 

return *this; 


} 


The return type is Permutation because the expression P=Q returns a value. The 
argument (corresponding to the right-hand side of an assignment expression) is a 
reference to a Permutation object named that. 

The first statement is delete[] data;. In the assignment statement P=Q;, the 
information held in P is replaced with a copy of that in Q. So we first discard the 
old data and then make a new one. (Alternatively, we could have checked if this 
permutation and that have the same value for n. If so, there would be no need to 
delete and then reallocate data.) 

The rest of the code is straightforward. We copy that .n, allocate space for data, 
and then copy the entries in that .data. 

Finally, we return a copy of the new value held in the left-hand side of the expres- 
sion with the statement return *this;. Alternatively, we could have ended with 
return that; because that holds the same information as «this. 


11.2.4 Basic inspection and modification methods 


We provide methods for inspecting and modifying Permutation objects. 


e@ getN() returns the value held in n. See line 24 of Permutation.h (Pro- 
gram 11.1). 


e swap (i, 4) exchanges the values 2(i) and 2(j). In conventional notation, 7 
is replaced by 70 (i,j) where 1 <i,j <n. See line 18 of Permutation.h 
and lines 48-54 of Permutation.cc (Program 11.2). 


e reset () leaves n unchanged but resets the permutation to the identity permu- 
tation. See line 20 of Permutation.nh and lines 44-46 of Permutation.cc. 


e randomize () leaves n unchanged but replaces 2 with a permutation chosen 
uniformly at random from S,,. There is an efficient algorithm for doing this. 
For k = 1,2,...,n, we swap the value held in 2(k) with the value held in 7(/) 
where j is chosen uniform at random from {k,k+1,k+2,...,n}. See line 19 
of Permutation.h and lines 56-63 of Permutation.cc. 
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We do not provide a way to modify directly the value held in data[i]; to do 
so may result in an invalid permutation. However, we do provide a mechanism for 
learning the value held in data[i] and this is explained next. 


11.2.5 Permutation operations 


There are three fundamental operations we want to be able to perform with per- 
mutations. First, given a permutation 7, we need to be able to obtain the value 2(k). 
Second, given two permutations 7 and 0, we want to calculate the composition 70 T. 
And third, given a permutation 2, we want to calculate z~!. We consider each of 
these in turn. 


e If P represents the permutation 7, we define P . of (k) to return the value 2(k). 
A way to do this is simply to return data[k]. However, we need to guard 
against a user that submits a value k that is less than 1 or greater than n. For 
such improper values of k, the easiest thing to do is to return k itself. 


The declaration of of is on line 25 of Permutation.h (Program 11.1) and 
the code is on lines 87-90 of Permutation.cc (Program 11.2). 


Permutations are functions, so it would be pleasant to be able to write P (k) to 
extract the value 2(k). Fortunately, this is possible. The key to doing this is to 
define operator (). On line 26 of Permutation.h we see the entire inline 
code for this operator: 


long operator() (long k) const { return of(k); } 


The first pair of parentheses (after the keyword operator) shows that we are 
defining P (k) where P is a Permutation and k is a long integer. The second 
pair of parentheses encloses the argument k. 


Consequently, the expressions P . of (k) and P (k) are equivalent to each other. 


e We define operator so that P«Q stands for the composition of two permu- 
tations. If P and Q have the same value of n, the meaning of the composition is 
clear. In case they have different values of n, the resulting Permutation 
is based on the larger of the two ns. See the code for details (line 30 of 
Permutation.h and lines 100-111 of Permutation.cc). 


The first statement in the operator» method (line 101) finds the larger of 
n and that.n using an interesting C++ operator called the trigraph. The 
statement is this: 


long nmax = (n > that.n) ? n : that.n; 


The syntax for the trigraph operator ?: is this: 


test ? val_l : val_2 


where test is a Boolean expression and val_1 and val_2 are two expres- 
sions. The result of the trigraph depends on the value of test. If test is 
true, then the value is val_1; otherwise, the value is val_2. The statement 
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x = test ? val_l : val_2; 


is equivalent to the following code. 


if (test) { 
x = val_l; 
} 
else { 
x = val_2; 


} 


The trigraph expression is handy if the subexpressions (test, val_1, and 
val_2) are not too complicated. 


In addition to defining operator«, we also provide operator*= so we may 
avail ourselves of statements such as Px=Q;. See line 31 of Permutation.h 
and lines 113-116 of Permutation.cc. 


e To calculate the inverse of a permutation, we provide an inverse method. 
See line 33 of Permutation.h and lines 118-122 of Permutation.cc. The 
statement Q = P.inverse(); assigns the inverse of P to Q, but leaves P un- 
changed. 


11.2.6 Comparison operators 


We provide four different methods for comparing permutations. The == operator 
checks that the values of n are the same in both permutations, and then if the data 
held in both match. We do not consider the identity permutation in two different S,,s 
to be the same. The != operator is equivalent to ! (P==Q). 

We also provide an operator< to compare Permutations; this is convenient if 
we wish to create a set (or other sorted container) of Permutations. 

Finally, we provide an isIdentity method that returns t rue if the object is the 
identity permutation. 

See lines 35-38 of Permutation-h and lines 124-152 of Permutation.cc 
(Programs 11.1 and 11.2, respectively). 


11.2.7 Output 


We define operator<< for writing permutations to the computer’s screen. We 
choose to write permutations in the disjoint cycle format. The operator is declared on 
line 41 of Permutation.h and the code is on lines 155-175 of Permutation.cc. 
The code uses a temporary array named done to keep track of which values have 
already been represented in cycles. See the code for details. 


11.2.8 The code file Permutation.c 


We close this section with the code file for the Permutation class. 
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Program 11.2: Program file for Permutation class. 


#include "Permutation.h" 
#include "uniform.h" 


Permutation::Permutation() { 
data = new long[2]; 


Permutation::Permutation(long nels) { 
if (nels <= 0) { 
nels = 1; 
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} 


data = new long[nels+1]; 


n = nels; 
for (long k=1; k<=n; k++) { 
data[k] = k; 


Permutation: :Permutation(long nels, 
dete (eS <0) a 
nels = 1; 
data = new long[2]; 
Gaiz ariel — alk 
TSE MEINE 
} 
n = nels; 
data = new long[nt+1]; 
for (long k=1; k<=n; k++) data[k] 
ie (Nelacele(j))) seeseic (() 2 


Permutation: :Permutation(const Permutation& that) 


n = that.n; 
data = new long[nt1]; 
for (long k=1; k<=n; k++) data[k] 


Permutation::~Permutation() { 
delete[] data; 


void Permutation::reset() { 
for (long k=1; k<=n; k++) data[k] 





void Permutation::swap(long i, long j) 
aie ( (<i) | Ciem) 1 (os) Ii) Cae) 


long a = data[i]; 
long b = data[j]; 
data[i] = b; 
data[j] = a; 


long* array) 


that.data[k]; 
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void Permutation::randomize() { 
k++) 
long j = unif (n-k+1)-1+k; 
long tmp = datal[jl]; 


iE@) 


bool Permutation: :check () 


lo 
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fo 
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} 
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re 


long Permutation::of(long k) 


Bas 
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data[j] 
data[k] 


ng*x temp; 


k<n; 


data[k]; 
tmp; 


mp = new long[n+1]; 


r (long k=1; 
ie 
delete[] 


(data [k] 
temp; 


k<=n; 
<n) 


return false; 


} 


temp[k] = data[k]; 


rt (tempt+1, 
r (long k=1; 
if (temp[k] 

delete[] 


k<=n; 
!'= k) 


temp; 


return false; 


lete[] temp; 
turn true; 
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return data[k]; 
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turn «this; 
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return k; 


k++) 


data[k] = that.data[k]; 


Permutation ans (nmax,tmp) ; 


de 
re 


lete[] tmp; 
turn ans; 


{ 


Permutation: :operator=(const Permutation& that) 


Permutation: :operatorx (const Permutation& that) 


i 


const { 
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111 } 

112 

113 Permutation Permutation: :operators*=(const Permutation&é that) { 
114 (GAteheS)) exe Dees) eee alter, 

115 return «this; 

116} 

117 

118 Permutation Permutation::inverse() const { 

119 Permutation ans(n); 

120 for (long k=1; k<=n; k++) ans.data[data[k]] = k; 
121 return ans; 

122 § 

123 

124 bool Permutation: :operator==(const Permutationé that) const { 
125 akie (Ga DE qeloeie ig) ietSieliein ecules 

126 

127 for (long k=1; k<=n; k++) { 

128 if (data[k] != that.data[k]) return false; 

129 } 

130 return true; 

131} 

132 

133 bool Permutation: :operator!=(const Permutationé& that) const { 
134 return !( («*this)==that ); 

135 } 

136 

137 bool Permutation: :operator<(const Permutation& that) const { 
138 aie (ig << (elaeye sil) see Buen ieieWeS 

139 ake (Gal “> GEIMSie iol) wei when IeeulSe¢ 

140 

141 for (long k=1; k<=n; k++) { 

142 Le (datelk | <-thet. datalkl}): ,etusn true: 

143 if (data[k] > that.data[k]) return false; 

144 } 

145 return false; 

146} 

147 

148 bool Permutation::isIdentity() const { 

149 for (int k=1; k<=n; k++) { 

150 if (data[k] != k) return false; 

151 } 

152 return true; 

153} 

154 

155 ostream& operator<<(ostream& os, const Permutation& P) { 
156 long n = P.getN(); 

157 boolx done = new bool[ntl]; 

158 for (long k=1; k<=n; k++) done[k] = false; 

159 

160 in@ye’ {(Aheyexe) eile leave arar)) 2 

161 if (!done[k]) { 

162 Os: << UC <S Iep 

163 done[k] = true; 

164 Lone: p= PG 

165 while (j!=k) { 


166 ES rete ek ee he 


167 
168 
169 
170 
171 
172 
173 
174 
175 
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done[j] = true; 
T= BCs 


delete[] done; 
return Os; 


} 








11.3 Finding monotone subsequences 


We now return to Ulam’s problem: what is the expected length of a longest in- 
creasing subsequence of a random permutation? The Permutation class includes 
a randomize method, so we are able to generate permutations uniformly at random 
in S,. Given a permutation, how do we find the length of a longest increasing (or 
decreasing) subsequence? 

The idea for the algorithm comes from the proof of the Erdés—Szekeres Theorem 
(Theorem 11.1). Given a permutation z € S,, we define the values u; (respectively, 
dj) to be the length of a longest increasing (respectively, decreasing) subsequence of 
7 starting at position i. To find the values u; and d; we work from right to left; that 
is, we start with i =n and work our way down. 

Clearly un = d, = 1 because the longest increasing (decreasing) sequence that 
starts from the last position has length exactly one. 

Now consider u,—; and d,_;. If a(n—1) < a(n), then the longest increasing 
subsequence starting at position n — | has length 2 and the longest decreasing subse- 
quence has length 1. On the other hand, if 7(n — 1) > a(n), then the longest increas- 
ing subsequence starting at position n — | has length 1 and the longest decreasing 
subsequence has length 2. In other words, 


_ J (2,1) ifa(n—1)<a(n), and 
ote = 408 if m(n—1) > x(n). 


Suppose we have established the values u; and d; fori =k-+1 through i=n. To 
find uz, we compare 7(k) sequentially with (k+ 1), a(k+2), and so on, up to 2(7). 
Among all indices j > k for which z(k) < 2(j), find the one for which uw; is largest. 
We then set u, = uj +1. If there are no indices j with a(k) < m(j), then we set 
uy = 1. 

The procedure for finding d;, is analogous. Among all indices j > k for which 
m(k) > m(j), we select the j for which d; is largest and set d, = dj;+ 1. If no such 
index j exists, we set d, = 1. 
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Let’s consider an example. For the permutation 7 = [1,4,7,2,5,3,6], suppose we 
have calculated u; and d; for all i > 3. We now want to find uz and d2. This is what 
we know so far. 

















Indexi |} 1/2/3/}4/5/6]7 
(i) 7 1/4/;7/2)/5/3]6 
Uj 2/2? 7173 )2)27 1 
dj 27/2? /7371)2); 171 
































To find uz, note that for indices j = 3, 5, and 7 we have 2(2) < m(j). Note that 
u3 = 1, u5 = 2, and u7 = 1, so us is largest. We therefore set uz = us + | = 3. Indeed, 
the longest increasing subsequence starting at position 2 is [4,5,6]. 

Finding d2 is analogous. For indices j = 4 and 6 we have 2(2) > a(j). Note that 
d4 = 1 and dg = 1, so we set dz = 2. 


We create a procedure named monotone that takes a Permutation as its argu- 
ment and returns a pair of long integers giving the lengths of the longest increasing 
and decreasing subsequences in the Permutation. Here is the header file, which 
we call monotone.h. 





Program 11.3: Header file monotone.h. 


#ifndef MONOTONE_H 
#define MONOTONE_H 


#include "Permutation.h" 
#include <utility> 


pair<long, long> monotone(const Permutation& P); 


#endif 





Note that we have #include <utility> because the monotone procedure re- 
turns a pair. The utility header file is needed to define the pair class. 

The code for this procedure is housed in a file named monotone.cc that we 
present next. 





Program 11.4: A program to find the length of the longest monotone subsequences 
of a permutation. 


#include "monotone.h" 


pair<long,long> monotone(const Permutation& P) { 
long* up; 
longs dn; 
long n = P.getN(); 


up = new long[n+1]; 
dn = new long[nt+1]; 


in@ue ((heyeve; Ie ile le<=iaye Near) 4 
up[k] = dn[k] = 1; 
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} 


(Ceravep sJSvearile sje jars) 
(2Usp > Bay) 

af (dele <= dal alte 2 
dale) = “dria lel; 


else { 
ise (WSs) <= Walla) { 
up[k] = up[j]+1; 
} 
} 
} 
} 
long up_max = 1; 
long dn_max = 1; 
for (long k=1; k<=n; k++) { 
if (up_max < up[k]) up_max = up[k]; 
if (dn_max < dn[k]) dn_max = dn[k]; 
} 
delete[] up; 
delete[] dn; 
return make_pair (up_max, dn_max) ; 





231 





The arrays up and dn are used to hold the sequences u; and dj. 
Finally, we need a main to generate random permutations repeatedly and calculate 
the average lengths of longest increasing and decreasing subsequences. Here is such 





a program. 
Program 11.5: A program to illustrate Ulam’s problem. 

#include "Permutation.h" 

#include "“uniform.h" 

#include "monotone.h" 

#include <iostream> 


using na 


int main 
long n 
long r 
SSS t) 


COUim 
Galig SS 
Come << 
(align SS 


Permut 


mespace std; 


Q) i 


; 

eps; 

; 

< "Enter n (Size of permutation) —-> "; 
n; 

< "Enter number of repetitions --> "; 
reps; 

ate lein IP (ia) 9 


19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32; 
33 
34 
35 
36 
37 
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long sum_up = 0; 
long sum_dn Os 


for (long k=0; k<reps; k++) { 
P.randomize(); 
pair<long, long ane; 
ans = monotone (P); 
sum_up += ans.first; 
sum_dn += ans.second; 


cout << "Average length of longest increasing subsequence is 


<< double (sum_up) /double(reps) << endl; 


cout << "Average length of longest decreasing subsequence is 


<< double(sum_dn)/double(reps) << endl; 


return 0; 





Here is the result of running this program for permutations in S, for n equal to 


10,000 for one hundred iterations. 





Enter n (size of permutation) --> 10000 
Enter number of repetitions -—-> 100 


Average length of longest increasing subsequence is 192.31 
Average length of longest decreasing subsequence is 192.94 


7 





For this case, we observe E(L,) /./n © 1.9. In fact, 








11.4 Exercises 


11.1 Devise a procedure or method to find the order of a permutation. (For a permu- 
tation 7, the order of 7 is the least positive integer k so that 7 is the identity.) 


11.2 Create a class name Counted that can keep track of the number of objects of 


type Counted which exist at any point in the program. That is, the Counted 
class should include a static method named count that returns the number 


of Counted objects currently in memory. 
For example, consider the following main (). 


#include "Counted.h" 
#include <iostream> 
using namespace std; 


int main() { 
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Counted X, Y; 
Counted* array; 
array = new Counted[20]; 


cout << "There are " << Counted::count () 
<< " Counted objects in memory" << endl; 


delete[] array; 


cout << "And now there are " << Counted::count () 
<< " Counted objects in memory" << endl; 


return 0; 


} 


This should produce the following output. 





‘a at 
There are 22 Counted objects in memory 


And now there are 2 Counted objects in memory 





(It’s hard to imagine a mathematical reason we might want to keep track of 
how many objects of a given sort are being held in memory, but this is a useful 
debugging trick to see if there is a memory leak.) 


11.3 Redo Exercise 8.5 (page 152) without using the container classes of the Stan- 
dard Template Library. That is, the parts of the partition should be held in a 
conventional C++ array and maintained in sorted order. This change requires 
you to create a copy constructor, an assignment operator, and a destructor. 


Replace the get_parts method by an operator[]; if P is a Partition, 
then the expression P [k] should give the kth part of the partition. 


11.4 Let n be a positive integer. Suppose that n points are placed in the unit cube 
(0, 1]°. Write a procedure to find the size s of a largest subset of these n points 
such that their coordinates satisfy 


Xp SXQ SHB Li Ss 


Yi Sy2 S¥3 S++ Ss 
Z1 SS %3 Si Ss 


Suppose the points are placed in the unit cube independently and uniformly 
at random. Use your procedure to conjecture the expected size of the largest 
such set. 


11.5 Create a class SmartArray that behaves as a C++ array on long values, but 
that allows any integer subscript. That is, a Smart Array is declared like this: 


SmartArray X(100); 


This creates an object x that has the same behavior as if it were declared 
long X[100]; but allows indexing beyond the range 0 to 99. An index of 
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k outside this range is replaced by k mod 100. In this way, x [-1] refers to the 
last element of the array (in this case X[99]). 


Hint: The hard part for this problem is enabling the expression X [k] to appear 
on the left side of an assignment. Suppose you declare the indexing operator 
like this: 


long operator[] (long k); 


Then you cannot have an expression such as X[2]=4;. The trick is to declare 
the operator like this: 


long& operator[] (long k); 


Create a class to represent linear fractional transformations. These are func- 


tions of the form 
at b 


f(z) 








~ oztd 
where z,a,b,c,d € C. 
Be sure to include an operator () for evaluating a linear fractional transfor- 


mation at a given complex number and an operator*« for the composition of 
two transformations. 


Create a Path class that represents a polygonal path in the plane (i.e., an or- 
dered sequence of Points in R7). Include the following methods: 


A default constructor that creates an empty path. 
e A one-argument constructor that creates a path containing a single point. 


e An operator+ that concatenates two paths, or concatenates a path and 
a point. (Be sure to take care of both Path+Point and Point+Path.) 


e An operator [] to get the kth point on the path. 


Chapter 12 





Polynomials 


In this chapter we create a C++ class to represent polynomials. The coefficients of 
these polynomials can be from any field K such as the real numbers, the complex 
numbers, or Z,,. One way to do this is to create several different polynomial classes 
depending on the coefficient field. A better solution is to learn how to use C++ 
templates. 





12.1 Procedure templates 


Imagine that we often need to find the largest of three quantities in our program- 
ming. We create a procedure named max_of_three like this: 


long max_of_three(long a, long b, long c) { 
if (a<b) { 
if (b<c) return c; 
return b; 
} 
if (b<c) return c; 
return b; 


} 


Then, the expression max_of_three (3, 6,-2) evaluates to 6. 
If we also want to find the maximum of three real values, we create another version 
of max_of_three: 


double max_of_three(double a, double b, double c) { 
if (a<b) { 
if (b<c) return c; 
return b; 
} 
if (b<c) return c; 
return b; 


} 


Pythagorean triples (see Chapter 7) can also be compared by <, so if we want to 
compare PTriple objects, we create yet another version of max_of_three: 


PTriple max_of_three(PTriple a, PTriple hb, PTriple c) { 
if (a<b) { 
if (b<c) return c; 
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return b; 
} 
if (b<c) return c; 
return b; 


} 


At some point, we may want to apply max_of_three to another class. We could 
write more and more versions of this procedure, each with a different first line to 
accommodate the additional types. 

The result is many different incarnations of the max_of_three procedure. This 
is legal in C++; one can have multiple procedures with the same name provided 
the types or number of arguments are different for each version. The procedure 
max_of_three (double, double, double) happily coexists with the version of 
max_of_three that acts on arguments of type PTriple. It is annoying that we 
need to create the exact same procedure over and over again for different types of 
arguments. Furthermore, if we want to change the algorithm for max_of_three, 
we need to edit all the different versions. 

Fortunately, there is a better way. It is possible to write a single version of 
max_of_three that automatically adapts to the required situation using templates. 
Here is the template for the max_of_three procedure. 








Program 12.1: The header file containing the template for the max_of_three pro- 
cedure. 


#ifndef MAX_OF_THREE_H 
#define MAX_OF_THREE_H 


template <class T> 

Hi uvsise One elonaSeu( el IP Jo, ab @)) 4 
Dede URE Ie 

die (lo<@)) TSiEUIIA EP 

return b; 

} 

aie (oKG)) KEE Ue ep 

return b; 


} 





fendif 





There are two points to notice. 


e The procedure is given, in full, in the header file, max_of_three.h. This is 
standard for templates. One does not separate the declaration in the header file 
from the code in the . cc file. 


In addition, the keyword inline is not needed. 
e The procedure begins with template <class T>. This sets up the letter T 
to stand for a type. 


The remainder of the code is exactly what we had before with T standing 
for long, double, PTriple, or any other type. The letter T acts as a “type 
variable.” 
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One may think of a template as a procedure schema. When the C++ compiler en- 
counters max_of_three in a program, it uses the template to create the appropriate 


version. 


For example, here is a main that utilizes the adaptable nature of max_of_three. 


#include "max_of_three.h" 
#include <iostream> 
using namespace std; 


_ 


int main() 
double x = 3.4; 
double y = -4.1; 
double z = 11.2; 


long a = 14; 

long b = 17; 

long c = 0; 

cout << "The max of " << x << ", "<< y << 
<< max_of_three(x,y,z) << endl; 

cout << "The max of " << a <<", ™ <<" b << 


<< max_of_three(a,b,c) << endl; 


return 0; 


} 


" 
, 


" 


" 


<< Z << 


KS Oe k< 


is 


is 


The first invocation of max_of_three has three double arguments; the compiler 
uses the max_of_three template with T equal to double to create the appropriate 
code. The second invocation has three long arguments, and as before, the compiler 
uses the template to create the appropriate version of the procedure. 


The output of this main is as we expect. 





The max of 3.4, -4.1, 11.2 is 11.2 
The max of 14, 17, 0 is 17 





The max_of_three template works for any type T for which < is defined. If < 
is not defined for the type, the compiler generates an error message. For example, 


consider the following main. 


#include <iostream> 
#include <complex> 
#include "max_of_three.h" 
using namespace std; 


int main() { 
complex<double> x(3,0); 
complex<double> y(-2,3); 
complex<double> z(1,1); 


cout << "The max of 
<< max_of_three(x,y,z) << endl; 


return 0; 


Woe <<, Myo << ys 


" 
, 


" 


<< Z << 
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When we attempt to compile this program, we get the following error messages (your 
computer might produce different error messages). 








max_of_three.h: In function ‘T max_of_three(T, T, T) [with T 
std::complex<double>]’: 

main.cc:12: instantiated from here 

max_of_three.h:6: error: no match for ‘std::complex<double>é& < 
std: :complex<double>&’ operator 

max_of_three.h:7: error: no match for ‘std::complex<double>& < 
std::complex<double>&’ operator 

max_of_three.h:10: error: no match for ‘std::complex<double>é < 
std::complex<double>&’ operator 





wy 





The compiler is complaining that it cannot find an operator< that takes two argu- 
ments of type complex<double> at lines 6, 7, and 10 in the file max_of_three.h; 
this is precisely where the < expressions occur. 


It is possible to create templates with multiple type parameters. Such templates 
look like this: 


template <class A, class B> 
void do_something(A argl, B arg2) { ... } 


When the compiler encounters code such as 


long alpha = 4; 
double beta = 4.5; 
do_something(alpha, beta); 


it creates and uses a version of do_something in which A stands for long and B 
stands for double. 





12.2 Class templates 
12.2.1 Using class templates 


In Section 2.7 we showed how to declare C++ variables to hold complex numbers. 
After the directive #include <complex>, we have statements such as these: 


complex<double> w(-3.4, 5.1); 
complex<long> z(4, -7); 


The first declares a complex variable w in which the real and imaginary parts are 
double real numbers and the second declares z to be a Gaussian integer (Long 
integer real and imaginary parts). 

The class complex is, in fact, a class template. By specifying different types 
between the < and > delimiters, we create different classes. For example, we could 
use the Mod type (see Chapter 9): 
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#include <complex> 
#include "Mod.h" 
using namespace std; 


int main() { 
Mod: :set_default_modulus (11); 
complex<Mod> z(4,7); 


cout << "Zz =" << z << endl; 
cout << "z squared = " << z*z << endl; 


return 0; 


} 


This program calculates (4+7i)” where 4 and 7 are elements of Z,; where we have 
(4+ 7i)? = —33+56i =i. This is confirmed when the program is run. 





c ~ 
z = (Mod(4,11),Mod(7,11) ) 
z squared = (Mod(0,11),Mod(1,11)) 





Likewise, vector is a class template. To create a vector that contains integers, 
we use vector<long>. To create a vector containing complex numbers with real 
coefficients, the following mildly baroque construction is required, 


vector<complex<double> > zlist; 


Note the space between the two closing > delimiters; the space is mandatory here. 
If it were omitted, the >> would look like the operator we use in expressions such 
as cin >> x causing angst for the compiler. For better readability, you may prefer 
this: 

vector< complex<double> > zlist; 


The pair class template takes two type arguments. To create an ordered pair 
where the first entry is a real number and the second is a Boolean, we write this: 


pair<double,bool> P; 


Using class templates is straightforward. The template is transformed into a spe- 
cific class by adding the needed type argument(s) between the < and > delimiters. 
The main pitfall to avoid is supplying a type that is incompatible with the tem- 
plate. For example, it would not make sense to declare a variable to be of type 
complex<PTriple> 

By the way: The use of < and > delimiters in #include <iostream> is unrelated 
to their use in templates. 


12.2.2 Creating class templates 


Now that we have examined how to use class templates we are led to the issue: 
How do we create class templates? The technique is similar to that of creating pro- 
cedure templates. To demonstrate the process, we create our own, extremely limited 
version of the complex template that we call mycomplex. The template resides in 
a file named mycomplex.h; there is no mycomplex.cc file. Here is the header file 
containing the template. 


COA NDNFP WHF TOAADHDNA PWN 
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Program 12.2: The template for the mycomp1lex classes. 


#ifndef MY_COMPLEX_H 
#define MY_COMPLEX_H 


#include <iostream> 
using namespace std; 


template <class T> 
class mycomplex { 


private: 
Ht saerelll Seyehicie? 
ial el cme chicitey 


porwoyll ake g 
mycomplex<T>() { 
real_part = T(0); 
imag_part = T(0); 


mycomplex<T>(T a) { 
real_part = a; 
imag_part TO) z 


mycomplex<T>(T a, T b) { 
real_part = a; 


imag_part = b; 
} 
ap ze@() xenaysiic, af scisicibueiy seSel_jeeueic Pe |} 
WT aga) Comic | wSicwuein swe) josie } 


}; 


template<class T> 

ostream& operator<<(ostream& os, const mycomplex<T>& z) 
OSs «< WU sx wemeGy << "ae (UY Re ees): << Was 
ieSewlaial SF 


fendif 


{ 





The overall structure of the class template is this: 


template <class T> 
class mycomplex { 

// private and public data and methods 
}; 


Let’s examine this code. 


e The initial template <class T> serves the same purpose as in the case 
of template procedures. This establishes T as a parameter specifying a type. 
When we declare a variable with a statement like this 


1 
2 
3 
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mycomplex<double> w; 


the T stands for the type double. See lines 7-8. 


e The class template has two private data fields: real_part and imag_part. 
These are declared as type T. Thus if w is declared type mycomplex<double> 
then w.real_part and w.imag_part are both type double. See lines 10— 
12. 


e Three constructors are given. The same name is used for these constructors: 
mycomplex<T>. (The <T> is optional here; the constructors could be named 
simply mycomplex with the <T> implicitly added.) 


The zero-argument constructor creates the complex number 0+ Oi. Note that 
the value 0 is explicitly converted to type T. This requires that type T be 
able to convert a zero into type T. If some_type is a class that does not 
have a single-argument numerical constructor, then declaring a variable to be 
a mycomplex<some_type> causes a compiler error. See lines 15-18. 


The single- and double-argument constructors follow (lines 20-28). They are 
self-explanatory. 


e We provide the methods re() and im() to retrieve a mycomplex variable’s 
real and imaginary parts. Note that the return type of these methods is T. See 
lines 30-31. 


e The last part of the file mycomplex.h is the operator<< procedure for writ- 
ing mycomplex variables to the computer’s screen. This procedure is not a 
member of the mycomp1ex class template, so it needs a separate introductory 
template <class T> in front of the procedure’s definition. See line 35. 


The next line looks like the usual declaration of the << operator. The second 
argument’s type is a reference to a variable of type mycomplex<T>. 


After this comes the inline code for the procedure. The keyword inline is 
optional because all templates must be defined inline. (If we want to include 
the keyword inline, it would follow template <class T> and precede 
ostreamé&.) 


Of course, to make this a useful template, we would need to add methods/procedures 
for arithmetic, comparison, exponentiation, and so forth. 

We could create a different version of mycomplex in which the real and imaginary 
parts are allowed to be different types. The code would look like this. 





Program 12.3: A revised version of mycomplex that allows real and imaginary 
parts of different types. 


template <class Tl, class T2> 
class mycomplex { 


4 
5. 
6 
7 
8 
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20 
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28 
29 
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31 
32 
33 
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private: 
Tl real_part; 
2) ame pers 


porte) Il aLe'g 
mycomplex() { 
real_part ail (0). 8 
imag_part = T2(0); 


mycomplex(Tl a) { 
real_part = a; 
imag_part = T2(0); 


mycomplex(Tl a, T2 b) { 
real_part = a; 
imag_part = b; 


Wil see) Coumisie if ixsicbueny geeell_joerece j} 
WA, sin) Cerise 4 weicibucid Gitere_joemicg }} 


}; 


template<class Tl, class T2> 

ostream& operator<<(ostream& os, const mycomplex<T1,T2>& z) { 
eS i ON ae EC epee TE oe PN ees er Pe Mi 
See CSP 





If we use this alternative mycomplex template, variable declarations require the 
specification of two types, such as this: 


mycomplex<long, double> mixed_up_z; 





12.3. The Polynomial class template 


Our goal is to create a C++ class template to represent polynomials over any field 
K and we call this class template Polynomial. Consider the following declarations, 


Polynomial<double> Py 
Polynomial< complex<double> > 0; 
Polynomial<Mod> R; 


These are to create polynomials in R[x], C[x], and Z,|x], respectively. (Of course, 
we need #include <complex> and #include "Mod.h".) 
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12.3.1 Data 


We need to store the coefficients of the polynomial. For this, we use a vector 
variable (see Section 8.4) named coef. The coefficient of x* is held in coef [k]. We 
therefore require the directive #include <vector> in the file Polynomial.h. 

We hold the degree of the polynomial in a long variable named dg. The degree is 
the largest index k such that coef [k] is nonzero. In the case where the polynomial 
is equal to zero, we set dg equal to —1. 

See lines 11-12 in Program 12.4. 


12.3.2 Constructors 


A basic, zero-argument constructor produces the zero polynomial. This is accom- 
plished by a call to a clear () method that resizes coef to hold only one value, 
sets that value to zero, and sets dg equal to —1. See lines 23-25 and 78-81 of Pro- 
gram 12.4. 


A single-argument constructor is used to produce a constant polynomial; that is, a 
polynomial in which c; = 0 for all k > 1. This constructor may be used explicitly or 
implicitly to convert scalar values to polynomials. For example, consider this code: 
Polynomial<double> P(5.); 

Polynomial<double> Q; 

Polynomial< complex<double> > R; 

Q= 6; 

R = -M_PI; 

The first line creates the polynomial p(x) = 5 using the constructor explicitly. The 
polynomials q(x) = 6 and r(x) = (—2 +i) both use the constructor implicitly. No- 
tice that for both Q and R there is also a conversion of the right-hand side of the as- 
signment into another numeric type. The 6 is an integer type and is cast into double 
for storage in Q. Similarly, -M_PI is a real number and this needs to be converted to 
a complex type for storage in R. 

To do this, we allow the argument to be of any type and then cast that argument to 
type kK. Let’s look at the full code for this constructor (lines 27-33): 

template <class J> 

Polynomial<K>(J a) { 

coef.clear(); 
coef.resize(l); 
coef[0] = K(a); 


deg_check (); 
} 


This constructor is a template within a template! (The outer template has the struc- 
ture template <class K> Polynomial { ... };.) Thus, in code such as 


Polynomial< complex<double> > P(val); 
Polynomial< complex<double> > Q; 
Q = val; 


the variable val may be of any type. 


244 C++ for Mathematicians 


There is, of course, a catch. We assign coef [0] with the value K (a). This is an 
explicit request to convert the value a to type K. This is fine if we are converting 
a long to a double or a double to a complex<double>, but fails when a is not 
convertible to type kK, for example, if K were type double and a were type PTriple. 


Notice the call to the private method deg_check (). This method scans the data 
held in coef to find the last nonzero value and resets dg accordingly. Various opera- 
tions on polynomials might alter their degree (e.g., addition of polynomials, changing 
coefficients, etc.) and this method makes sure dg holds the correct value. 


Next we have a three-argument constructor (lines 35-43). To create the polyno- 
mial ax? + bx +c one simply invokes Polynomial<K>(a,b,c). As before, the 
three arguments need not be type kK; it is enough that they be convertible to type Kk. 
For example, consider this code. 


long a= 7; 
complex<double> b(4.,-3.); 
double c = MPI; 


Polynomial< complex<double> > P(a,b,c); 


This creates a polynomial P equal to 7x” + (4—3i)x4+ 2. 


Finally, it is useful to be able to create a polynomial given an array of coefficients. 
The constructor on lines 45-60 takes two arguments: the size of an array and an 
array of coefficients. The array is declared as type J«; that is, an array of elements 
of type J. The only requirement on J is that values of that type must be convertible 
to type K. 


12.3.3 Get and set methods 


We include an assortment of methods to inspect and modify the coefficients held 
ina Polynomial. 


e The deg() method returns the degree of the polynomial. (See line 62.) 


e The get (k) method returns the coefficient of x*. In the case where k is invalid 
(negative or greater than the degree), we return zero. (See lines 64-67.) 


As an alternative to get (k) we provide operator [] (line 69). For a polyno- 
mial P, both P[k] and P. get (k) have the same effect. However, we have not 
set up operator [] to work on the left-hand side of an assignment; we cannot 
change the kth coefficient by a statement such as P [k]=c;. 


e The isZero() method returns true if the polynomial is identically zero. See 
line 89. 


e The set (idx,a) method sets the coefficient coef [idx] equal to the value 
a. See lines 71-76. 
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Some care must be taken here. First, if idx is negative, no action is taken. If 
idx is greater than the degree, we need to expand coef accordingly. Also, this 
method might set the highest coefficient to zero, so we invoke deg_check (). 


e The clear () method sets all coefficients to zero. See lines 78-82. 


e The minimize() method frees up any wasted memory held in coef. It is 
conceivable that a polynomial may at one point have large degree (causing 
coef to expand) and then later have small degree. Although the size of coef 
grows and shrinks with the degree, the capacity of coef would remain large. 
This method causes the vector method reserve to be invoked for coef. See 
lines 84-87. 


Finally, we have the shift (n) method. See lines 91-105. 


If n is positive, this has the effect of multiplying the polynomial by x”. Each 
coefficient is shifted upwards; the coefficient of x* before the shift becomes 
the coefficient of x**” after. 


Shifting with a negative index has the opposite effect. Coefficients are moved 
to lower powers of x. Coefficients shifted to negative positions are discarded. 





The polynomial P 4x + 6x —2 
AfterP.shift (2) | 4x7+6x° — 2x? 
After P.shift (-1) | 4x+6. 




















Notice that we give the argument n a default value of | (see line 91). Thus 
P.shift() is the same as P. shift (1). 


12.3.4 Function methods 


Polynomials are functions and to use them as such we provide a method named 
of. Invoking P. of (a) evaluates the polynomial p(x) at x =a. See lines 109-118. 

An efficient way to evaluate a polynomial such as 3x4 + 5x? — 6x* + 2x+7 atx=a 
is this: 


(((@ xa) +5) x a+ (-6))xa+2) xa+7. 


In addition to the of method, we provide an operator () method (line 120). 
This way we can express function application in the natural way P (a) in addition to 
P.of(a). 


Because polynomials are functions, they may be composed and the result is again 
a polynomial. We use the same method names, of and operator (), for polynomial 
composition. For polynomials P and Q, the result of P. of (Q) (and also P (Q) ) is the 
polynomial p(q(x)). See lines 122-135. 

These methods depend on the ability to do polynomial arithmetic, and we describe 
those methods below (Subsection 12.3.6). 
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12.3.5 Equality 


To check if two polynomials are equal, we make sure they have the same degree 
and that corresponding coefficients are equal. The operators == and != are given on 
lines 139-149. 


12.3.6 Arithmetic 


We provide methods for the usual arithmetic operators: addition, subtraction, mul- 
tiplication, and division (quotient and remainder). See lines 153ff. 
Each of the basic operators is defined like this: 


Polynomial<K> operator+(const Polynomial<K>& that) const { ... } 


If P and Q are of type Polynomial<double>, then the expression P+Q invokes this 
method with that referring to 0. However, the expression P+5 also engages this 
method; implicitly the 5 is cast to a polynomial via Polynomial<double> (5). 
However, the expression 5+P cannot be handled by this method (because 5 is not a 
polynomial). Therefore, we also provide procedure templates such as this: 


template <class J, class K> 
Polynomial<K> operator+(J x, const Polynomial<K>& P) { 
return P + K(x); 


} 


See lines 291-298. 

In addition to the usual operators + - » / % we provide their operate/assign 
cousins: += -= x= /= %=. We also give methods for unary minus and exponenti- 
ation (to a nonnegative integer power). 

With the exception of division, the code for these various operators is reasonably 
straightforward. Division requires a bit more attention. 

As in the case of integers, division of polynomials produces two results: the quo- 
tient and the remainder. Let a(x) and b(x) be polynomials with b 40. Then there 
exist polynomials g(x) and r(x) for which 


a(x) = q(x)b(x) + r(x) and degr(x) < degb(x). 


Furthermore, g and r are unique. For example, if a(x) = 3x? -+x—2 and b(x) = 2x+1, 
then g(x) = 3x— i and r(x) = —4. 

We define A/B and A%B to be the quotient and remainder, respectively, when we 
divide a(x) by b(x). 

To this end, we define the procedure quot_rem(A,B,Q,R) (see lines 300-321) 
to find the quotient and remainder. The operator/ and operator’ make use of 
quot_rem to do their work. 

Please note that the division methods require that K be a field. If K is only a 
commutative ring (e.g., long integers), then most of the class template works fine, 
but the division methods do not. 


1 
2 
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12.3.7 Output to the screen 


The operator << for writing to the computer’s screen appears on lines 269-289. 
This operator writes the polynomial 5x° — x + 5 like this: 


(S273 + (=D) XR + (0.5) 


The procedure is smart enough to omit terms whose coefficient is zero, to omit the 
superscript | on the linear term, and to omit the variable altogether on the constant 
term. However, it does not convert (—1) X into the more legible - X,oreven- (1) xX. 
We might think that it is possible for the code to check if a coefficient is negative and 
modify behavior accordingly. However, for some fields K (such as C and Z,) this 
does not make sense. 


12.3.8 GCD 


Let a(x) and b(x) be polynomials. A common divisor of a(x) and b(x) is a poly- 
nomial c(x) with the property that there exist polynomials s(x) and t(x) so that 
a(x) = c(x)s(x) and b(x) = c(x)t(x). A greatest common divisor of a(x) and b(x) 
is acommon divisor of highest possible degree. 

Two polynomials may have several different greatest common divisors because 
any nonzero scalar multiple of a greatest common divisor is again a greatest common 
divisor. 

To settle on a specific meaning for gcd[a(x),b(x)] we choose the greatest common 
divisor d(x) whose leading coefficient is 1. (A polynomial whose leading coefficient 
is 1 is called monic.) Any two nonzero polynomials have a unique monic greatest 
common divisor. 

The gcd procedure for two polynomials is given on lines 323-336. This proce- 
dure uses the helper methods is_monic() and make_monic(); the former checks 
if the polynomial is monic and the latter transforms the polynomial into a monic 
polynomial by dividing by the leading coefficient. See lines 256-265. 

We use the Euclidean algorithm (described in Section 3.3) to calculate the gcd of 
two polynomials. 


In addition to the usual gcd procedure, we provide an extended version. Given 
polynomials a(x) and b(x), the extended gcd procedure finds d(x) = gcd[a(x),b(x)] 
as well as polynomials s(x) and t(x) so that d(x) = a(x)s(x) + b(x)t(x). See lines 
337-376. 


12.3.9 The code 


Here is the listing of Polynomial.h. This includes the Polynomial<k> class 
template as well as associated procedure templates (operator<<, gcd, etc.). 





Program 12.4: Header file for the Polynomial class template. 


#ifndef POLYNOMIAL_H 
#define POLYNOMIAL_H 





CAANDUNMNFPWNK TU AAAHMN SW 


39 





K 
COmAANADNAKWNK OS 


NAaanrnrnnrnrnnn 
erAININDNFWNK OS 
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#include <vector> 
#include <iostream> 
using namespace std; 


template <class K> 
class Polynomial { 


private: 
vector<K> coef; 
long dg; 


void deg_check() { 


elegy = =ilp 
ito (lhemg b=Or Kk< lemme (leost, Size) )e Ie) 4 
if (coef[k] != K(0)) dg = k; 


} 


coef.resize(dgt1); 


poruile Il a6" 2 
Polynomial<K>() { 
clear(); 


template <class J> 

Polynomial<K>(J a) { 
coef .clear(); 
coef.resize(1); 
coef[0] = K(a); 
deg_check (); 


template <class J, class JJ, class JJJ> 
Polynomial<K>(J a, JJ b, JJd c) { 


coef.resize(3); 
coef [2] K(a); 
coef[1] = K(b); 
SoS LO] = KMS) § 
deg_check (); 


template <class J> 
Polynomial<K>(long array_size, const J* array) 
pista (cisiaciyymacelnZ © aa) (| 
coef.clear(); 
coef.resize(1); 
COS O] = KO) ¢ 


coef.clear(); 

coef.resize(array_size); 

ie@e (leisy IeSOle Ne<euciceiy salve Iker) 
coef[k] = K(array[k]); 





109 
110 
111 
112 
113 
114 


long deg() const { return dg; } 


K 
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deg_check (); 


get (long k) const { 
cite (ake) 
return coef [k]; 


(k>dg) ) return K(0); 


operator[] (long k) const { return get(k); } 


RVi@EE Cline & ites ( GGT Gjimsl Clixg, ee eects) eee 


air ((Giche << @)) seeieiuieins 

aie (ickeril, Salers; (emait . SS ()) ))) 
coef[idx] = a; 

deg_check (); 





void clear() { 


coef.resize(l1); 
dg = -l; 
coef[0] = K(0); 


void minimize() { 


deg_check (); 
coef.reserve (dgt1); 


GOcme re ssez craic ils) E- 


bool isZero() const { return (dg < 0); } 


void shift(long n= 1) { 


if (n==0) return; 

DE CEOs 
for (long k=0; k<=dgtn; k++) coef[k] = coef[k-n]; 
for (long k=dgtnt+l; k<=dg; k++) coef[k] = K(0); 
deg_check () ; 
TOSNE WIENS 

} 

coef.resize(ntdg+1) ; 

for (long k=dg; k>=0; k--) coef[k+n] = coef[k]; 

for (long k=0; k<n; k++) coef[k] = K(0); 


dg += n; 


// FUNCTION APPLICATION // 


K 


(Opes (anc!) MES © Instead 

if (dg <= 0) return coef[0]; 
i elias} p 

ans = K(0); 

irene (keine ieoelojp ike=O\s Ik==)) 4 


ans *= a; 
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115 ans += coef[k]; 

116 :: 

117 return ans; 

118 a 

119 

120 K operator() (K a) const { return of(a); } 

121 

122 Polynomial<K> of (const Polynomial<K>& that) const { 
123 if (dg <= 0) return Polynomial<K>(coef[0]); 

124 

125 Polynomial<K> ans(K(0)); 

126 roe [(keitey MeSeleje ike =O)\S 1e==)) 4 

127 ans *= that; 

128 ans += Polynomial<K>(coef[k]); 

129 . 

130 ISIE UME Clais\9 

131 e 

132 

133 Polynomial<K> operator() (const Polynomial<K>& that) const { 
134 return of (that) ; 

135 } 

136 

137 // COMPARISON // 

138 

139 bool operator==(const Polynomial<K>& that) const { 
140 if (dg != that.dg) return false; 

141 for (long k=0; k<=dg; k++) { 

142 if (coef[k] != that.coef[k]) return false; 

143 } 

144 TSE UNE IIe 

145 a 

146 

147 bool operator!=(const Polynomial<K>& that) const { 
148 return !(*this == that); 

149 } 

150 

151 // ARITHMETIC // 

152 

153 Polynomial<K> operator+(const Polynomial<K>& that) const { 
154 Polynomial<K> ans; 

155 long dmax — (dg > thar .dg) 2 .dg =: ehat.dg; 

156 ans.coef.resize (dmaxtl1l) ; 

157 for (long k=0; k<=dmax; k++) { 

158 ans.coef[k] = get(k) + that.get(k); 

159 } 

160 ans .deg_check () ; 

161 ISIE UMIEI ~Sue\s\9 

162 . 

163 

164 Polynomial<K> operator+=(const Polynomial<K>& that) { 
165 («*this) = («this) + that; 

166 return xthis; 

167 

168 

169 Polynomial<K> operator-—() const { 


170 Polynomial<K> ans; 
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171 ans.coef.resize(dgt1); 

172 for (long k=0; k<=dg; k++) ans.coef[k] = -coef[k]; 
173 ans.deg_check (); 

174 lee Uliaial <salisl 9 

175 } 

176 

1G Polynomial<K> operator-(const Polynomial<K>& that) const { 
178 Polynomial<K> ans; 

179 llejave; chinese = (ele, S jeloxshe cle) 2 tole © ielaeic cles 

180 ans.coef.resize(dmaxtl1l) ; 

181 for (long k=0; k<=dmax; k++) { 

182 ans.coef[k] = get(k) - that.get(k); 

183 } 

184 ans .deg_check () ; 

185 return ans; 

186 } 

187 

188 Polynomial<K> operator-=(const Polynomial<K>é& that) { 
189 Gindsy (= (ebhis)) = thats 

190 return *this; 

191 } 

192 

193 Polynomial<K> operator* (const Polynomial<K>& that) const { 
194 Polynomial<K> ans; 

195 Lf (usZero() ||\\i that.isZerot)) return ans; 

196 long dans = dg + that.dg; 

197 ans.coef.resize(danst1); 

198 for (long k=0; k<=dans; k++) { 

199 K c(0); 

200 for (long j=0; j3<=k; j++) { 

201 if ((j<=dg) && (k-j<=that.dg)) c t= coef[j]*that.coef[k-j]; 
202 } 

203 ans.coef[k] = c; 

204 } 

205 ans.deg_check (); 

206 ieSieUlieial suas? 

207 } 

208 

209 Polynomial<K> operator«=(const Polynomial<K>& that) { 
210 Selle = (Grielie)) = iclaenep 

211 return xthis; 

212 } 

213 

214 Polynomial<K> pow(long k) const { 

215 if (k==0) return Polynomial<K> (1); 

216 if (k==1) return xthis; 

217 

218 if (k%2 == 0) { 

219 long half_k = k/2; 

220 Polynomial<K> ans; 

221 ans = («*this) .pow(half_k); 

222 sins = eualsip 

223 return ans; 

224 } 


225 
226 long half_k = (k-1)/2; 
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227 Polynomial<K> ans; 

228 ans = (x*this) .pow(half_k); 

229 ans *= ans; 

230 ans *= xthis; 

231 ISDE UMIEIN Sue\S\y 

232 } 

233 

234 Polynomial<K> operator/ (const Polynomial<K>& that) const 
235 Polynomial<K> Q,R; 

236 Coir Keil, ieleetc, ©, IRF 

237 return QO; 

238 } 

239 

240 Polynomial<K> operator/=(const Polynomial<K>& that) { 
241 xthis = (*this)/that; 

242 return xthis; 

243 } 

244 

245 Polynomial<K> operator% (const Polynomial<K>& that) const 
246 Polynomial<K> Q,R; 

247 Clie Temas, qlee. Op IVF 

248 return R; 

249 } 

250 

251 Polynomial<K> operator%=(const Polynomial<K>& that) { 
252 Grains) = (Geeloas)) % ielteies 

253 return *this; 

254 } 

255 

256 void make_monic() { 

257 Le (Gy Uy Peruri: 

258 K lead = coef[dg]; 

259 roxe (kei F=0e W<Scleje Gs) Gesielig]) = ieee 
260 } 

261 

262 bool te-monie(), const { 

263 clic tea (CLC <n) Beige tauitorage teclasieye 

264 return coef[dg] == K(1); 

265 } 

266 

267 ie // end of Polynomial<K> class template 
268 


269 template <class K> 
270 ostream& operator<<(ostream& os, const Polynomial<K>é& P) { 


271 ait (Pcie) <= O) Y 

272 OS KK UD Ke PIO) «q B)yM¢ 

273 return os; 

274 } 

275 for (long k=P.deg(); k>=0; k--) { 
276 aie (Pte) t= ke(O)) i 

277 aac (is <1? aclexe () yy si << ar Ue 
278 OS << YY <<< Pel] ae Ys 

279 tae ((Wesal)) 

280 OST AUX TU a 

281 continue; 


282 } 


308 
309 





328 


331 


335 
336 
337 


ae (isS=il) i 
os << "X"; 


} 

return os; 
template <class J, 
return P + K(x); 


template <class J, 





template <class J, 














return P « K(x); 





template <class K> 


Class 


Polynomial<K> operator+ (J 


} 


class 


Polynomial<K> operator-(J 
msc (2) a 1G) pe } 


class 


} 


K> 
Xx, 


K> 
Xx, 





K> 


Polynomial<K> operator* (J x, 
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const Polynomial<K>& P) 


const Polynomial<K>& P) 











const Polynomial<K>& P) 


void quot_rem(const Polynomial<K>é& A, 
const Polynomial<K>& B, 
Polynomial<K>& Q, 
Polynomial<K>& R) { 


Q.clear(); 
R.clear(); 


Polynomial<K> AA (A); 


while (AA.deg() 


>= B.deg()) 


Pi Ceyny Cie AA 


{ 


long k = AA.deg()-B.deg(); 
Polynomial<K> BB = B; 


BB. shift (k) ; 


K a_lead = AA[AA.deg()]; 
K b_lead = BB[BB.deg()]; 
<= BIE Clee (a ars) Ev) 


ee (keine; FHOR 
AA -= BB; 


Q.set (k,a_lead/b_lead) ; 


} 
R = A — Q«B; 


template <class K> 


Polynomial<K> gcd(const Polynomial<K>& A, 


aie (IB), ais ee@) (0) J) 


aie, (JN ale senveyous.@ (()) )) 


{ 


Polynomial<K> AA(A); 
AA.make_monic(); 


return AA; 


Polynomial<k> CC; 
C = A&B; 
return gcd(B,C); 


return A; 
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-set(j, BB[j]*a_lead/b_lead) ; 


const Polynomial<K>& B) 


{ 
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template <class K> 
Polynomial<K> gcd(const Polynomial<K>& A, 
const Polynomial<K>& B, 
Polynomial<K>é& S, 
Polynomial<K>& T) { 
Polynomial<K> D; // holds the answer 


// I£ A and B are both 0, set S=T=0 and return 0. 
if (A.isZero() && B.isZero()) { 

S.Cileyewe())\p 

T.clear(); 

return D; 


// If A is not 0 but B is, D = A/a_lead, S = a_lead, T = 0 
aie (1B), ahyeaeireoy(() )) 4 

= Ap 

a_lead = A[A.deg()]; 

-make_monic(); 

= Polynomial<K>(K(1)/a_lead) ; 

pieikecne (()) 2 

return D; 


i) {ge} toy exh lo) 


// Neither A nor B is zero, so we recurse 


Polynomial<K> Q; 
Polynomial<K> R; 
quot_rem(A,B,Q,R); 


Polynomial<K> SS; 
Polynomial<kK> TT; 


D Ciech(S IN, Sisig I) 2 


S = TIT; 
T = SS — Q«TT; 


return D; 


fendif 








12.4 The GCD problem revisited 


In Chapter 3 we considered the question (phrased imprecisely here): What is the 
probability that two positive integers are relatively prime? We found that the answer 
is 1/€(2). Here we consider a similar problem: What is the probability that two 


RON 
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randomly chosen polynomials are relatively prime? 

To be more precise, let By denote the set of all polynomials in Z2[x] of degree 
less than d; there are 24 such polynomials ag—1x4!| + ag_oxt-* +--+» Fax +ao 
where the ajs are 0 or 1. Let pg denote the probability the two polynomials, chosen 
uniformly and independently from By are relatively prime. What can we say about 
Pa asd — ~? 

To formulate a conjecture, we write a program to evaluate pg by direct enumera- 
tion. This is the approach we used in Section 3.5. With luck, modest values of d will 
lead us to the answer. The overall structure of the program is this: 


1. Ask the user to input d. 
2. Build an array containing all the polynomials in By. 


3. For all i < j, count the number of times the ith and jth polynomials are rela- 
tively prime. 


4. From this count, we learn the numerator of pg. Divide by 274 to find the 
answer. 


Of these, the most difficult part is the construction of the list in step 2. To generate 
this table efficiently, we observe that there is a natural one-to-one correspondence 
between d-digit binary numbers and polynomials in Bg, illustrated here with d = 6. 


000000 «— 0 
000001 « 1 
000010 «= x 
000011 «= x+1 
000100 << x 
000101 & x41 
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Integer values are stored in computers in binary, so our first step is to write a proce- 
dure to convert integers into polynomials: 


bg_-\bg_-2...b{b9 te bye bg A eee € By 


We call this procedure long2pol1y. Here is its header file. 





Program 12.5: Header file Long2poly.h. 


#ifndef LONG_TO_POLY_H 
#define LONG_TO_POLY_H 


#include "Polynomial.h" 


rFroOoOMAmAnANIanAMN 
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#include "Mod.h" 
COncsite vongmmaxaslo let sm— mois, 
Polynomial<Mod> long2poly (long m); 


fendif 





This header defines a constant max_bits that sets an upper bound on d; this value 
is based on the size of a Long integer on the computer on which this program is to 
be run. 

The procedure takes a long integer argument and returns a Polynomial<Mod>. 
To write this program, we want to access the individual bits of the integer argument, 
m. The way we do this is to check if m is even or odd, and then set bp accordingly. We 
then divide m by 2, check if the result is even or odd, and then set d;. We continue in 
this fashion until m is zero. Here is the code. 





Program 12.6: Code file for the Llong2po1y procedure. 
#include "“long2poly.h" 


Polynomial<Mod> long2Zpoly(long m) { 
Polynomial<Mod> ans; 


Long 3 = 0; 

while (m != 0) { 
ans.set(j, Mod(m,2)); 
m /= 2; 
jtt; 


return ans; 





Next, we need a main to implement the exhaustive algorithm. 





Program 12.7: Main program for the GCD revisited problem. 
#include "Polynomial.h" 
#include "Mod.h" 
#include "long2poly.h" 


using namespace std; 


int main() { 
long d; 
cOut << “Enber legres bound uae My 
Gali SS lg 


tf of “Cadel i) tdemax bate) J 4 
cerr << "Please choose d between 1 and " << max_bits << endl; 
return 0; 


39 
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long bound = l<<d; 
Polynomial<Mod> xlist; 
list = new Polynomial<Mod> [bound]; 


cerr << "Generating polynomials Le 
for (long k=0; k<bound; k++) { 
list[k] = long2poly (k); 
} 
cerr << "done! " << endl << bound 
<< " polynomials of degree less than " 
<< d <<" generated" << endl; 


long count = 0; 
const Polynomial<Mod> one (Mod(1,2)); 


ore (Clheine aSOp adeoitiiaclaiky aah) 4 
oie ((keievey GjSaisriks yoo@winels Gjarsr)) 


age ( @erel(Glitere (sh) plats | a)). SS Gacy )) exeibisliessss 
} 
} 
count = 2*count + 1; 
Cou K<< Gouin «<K VW oObhe Ox Y K< loyobiayelkexveitnarel 


<< " pairs are relatively prime" << endl; 


cout << count / (double(bound) * double(bound)) << endl; 


return 0; 
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Finally, when the program is run, we see the following. 





Enter degree bound --> 10 

Generating polynomials ... done! 

1024 polynomials of degree less than 10 generated 
524289 out of 1048576 pairs are relatively prime 
0.500001 





The formulation of a conjecture, and its proof,! are left as an exercise for the 


reader. 


'For a proof via generating functions, see S. Corteel, C. Savage, H. Wilf, D. Zeilberger, A pentagonal 
number sieve, Journal of Combinatorial Theory, Series A 82 (1998) 186-192. Recently, Art Benjamin 


and Curtis Bennett have found a bijective proof (submitted for publication). 
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12.5 Working in binary 


The long2poly procedure used a trick to convert a long integer m into polyno- 
mials p(x) in Zp[x]. We set the constant coefficient of p(x) based on the parity of m, 
and then we divided m by 2 (keeping only the integer part). We then repeated this 
technique to set higher and higher coefficients until m vanished. In short, we used 
division arithmetic to read off the base-2 digits of m. 

In other words, we used a mathematical trick to find the binary representation of 
m. However, the binary is already present inside the computer; it is more efficient to 
work directly with that. C++ provides a family of operators for working directly on 
the bits in the binary form of integers. 


12.5.1 Signed versus unsigned integers 


Integers are stored inside the computer in binary. The number 20 is represented 
internally as 0000000000010100. 

In this, and subsequent examples, we assume the integers are held as short types; 
on my computer these are two bytes (16 bits) long. Other integer types may have 32 
or 64 bits. 

The storage of negative integers is mildly counterintuitive. The leftmost bit is 
known as the sign bit. If this bit is 1, the number represented is negative. However, 
—20 is not represented as 1000000000010100. Look closely at the correct internal 
representation of —20 and 19: 





Value | Binary representation 
—20 | 1111111111101100 
19 | 0000000000010011 

















For a positive integer n, the binary representation of n is just the usual base-2 rep- 
resentation. However, the binary representation of —n is formed by complementing 
the bits of n — 1. Of course, zero is represented by an all-zero binary number. 

This manner of storing negative values is known as the twos complement repre- 
sentation. This representation is used for the sake of computational efficiency. 


The integer types (char, short, int, and long) all have variants that restrict 
their range to nonnegative values. These variant types prepend the word unsigned 
to the type name. For example: 


unsigned short x; 
To illustrate the difference, suppose we have two variables x and y declared thus: 


unsigned short x; 
short y; 


Suppose both of these hold the bits 1111111111111111. In this case, the value of 
x is 65,535 (2!© — 1) whereas the value of y is —1. 
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12.5.2 Bit operations 
C++ provides six operators for working with the binary representation of integers. 
Bitwise and For integer variables x and y, the expression xéy is the bitwise and of 


x and y. That is, the kth bit of xy is 1 if and only if the kth bits of both x and 
y are 1. Here is an example. 





x 0100001101100000 
y 0001000111101101 
x&y | 0000000101100000 

















The bitwise and operation « should not be confused with the Boolean and 
operation &&. You should use && only with bool values. 


Bitwise or Similar to bitwise and, the operation x | y gives the bitwise or of x and y. 
That is, the kth bit of x | y is 0 if and only if the Ath bits of both x and y are 0. 
Here is an example. 





x 0100001101100000 
y 0001000111101101 
x|y | 0101001111101101 

















The bitwise or operation | should not be confused with the Boolean or opera- 
tion | |. You should use | | only with bool values. 


Exclusive or The expression x*y gives the bitwise exclusive or of x and y. That is, 
the kth bit of x | y is 0 if and only if exactly one of the kth bits of both x and y 
is 1. Here is an example. 





x 0100001101100000 
0001000111101101 
xy | 0101001010001101 





IK 














Bitwise not The expression ~x interchanges Is and Os in x. That is, the kth bit of 
~x is | if and only if the kth bit of x is 0. Here is an example. 





x | 0100001101100000 
“x | 1011110010011111 














The bitwise not operation ~ should not be confused with the Boolean not op- 
eration !. You should use ! only with bool values. 


Left shift The expression x<<n (where n is a nonnegative integer) shifts the bits of 
x to the left n steps. The right-hand side of the result is filled with Os. Any bits 
in the highest n positions are lost. Here is an example. 





x 0100001101100000 
x<<5 | 0110110000000000 
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The symbol << is the same one we use for writing to the console, as in the 
statement cout << x << endl;. C++ is able to distinguish between these 
cases by inspecting the types of objects on either side of the << symbol. 


The expression x<<n is equivalent to multiplying x by 2” (unless bits are lost 
at the left). 


Right shift The expression x>>n (where n is a nonnegative integer) shifts the bits 
of x to the right n places. Bits in the lower n places are lost. The vacated 
positions on the left are filled in with Os or with 1s depending on the situation: 

e If x is an unsigned integer type, Os are inserted at the left. 


e If x is a signed integer type and x is nonnegative, Os are inserted at the 











left. 
e If x is a negative integer, then Is are inserted at the left. Here are some 
examples. 
short x 0010010010001010 
x>>5 0000000100100100 
unsigned short y | 1000110010110111 
y>>5 0000010001100101 
short z 1000110010110111 
Z>>5 1111110001100101 











The right shift operator >> uses the same symbol we use for keyboard input, 
for example, cin >> x;. As with left shift, C++ distinguishes these cases by 
inspecting the types of the objects on either side of the >> symbol. 


All six of these operators can be combined with the assignment operator, =. The 
expression x &= y is equivalent to x = (x&y),and soon. 

Bit operations can be combined to perform operations that would be difficult with 
standard mathematical operators. For example, suppose we want to set the kth bit of 
x to 1; the following code does the trick: x |= (1<<k);. If we want to set that bit 
to zero, we do this: x &= ~ (1<<k);. 


12.5.3 The bitset class template 


Using integer types to represent a list of binary values is efficient, but presents two 
drawbacks. First, this technique is limited to the size of an integer on your computer; 
if you want a list of, say, 200 bits, there is no integer type with that capacity. Second, 
using bit manipulation can result in obfuscated code. Human beings find statements 
such as x&=" (1<<k) ; difficult to understand. (The statement sets the kth bit of x to 
zero.) If your problem requires high speed for short lists of bits, then bit manipulation 
of integer types may be your best option. However, there are two other choices of 
which you should be aware. 

The first option, also discussed in Section 8.4, is to use vector<bool> vari- 
ables; these are adjustable arrays of true/false values. To set the kth bit of such an 
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array equal to zero (false), we use the considerably clearer statement x [k]=0; 
or x[{k]=false;. Variables of type vector<bool> use memory efficiently, can 
be easily resized, and provide convenient access to their elements. However, the 
bitwise operations (such as &, ~, >>, etc.) cannot be used with variables of type 
vector<bool>. If one wished to interchange all the Os and Is held in x, the state- 
ment x=~x; does not work. Instead, one would need to write a for loop to change 
the bits one by one: 
for (int k=0; k<x.size(); k++) { 

x[k] = !x[k]; 
} 


The second option is to use a bitset. A bitset object is a fixed size reposi- 
tory of bits. To use variables of type bit set, start with #include <bitset> and 
declare variables like this: 


bitset<100> x; 
This sets up x as a list of 100 bits. Notice that bit set is a template but its argument 


is a number, not a type; we explain how to do this later in this section. The important 
point is that this number is a constant, not a variable. The following code is illegal. 


int n; 

cout << "Enter number of bits --> "; 

cin >> n; 

bitset<n> x; // illegal constructor, n is not a constant 


The size of the bit set must be declared when you write your program, not while 
the program is running. 
Here is a list of the various methods and operators available for bit sets. 


e Constructors. The standard constructor has the form 


bitset<number> var; 


where number is a specific positive integer. This may bea const int defined 
earlier in the code, or an explicitly typed value, such as 100. The variable var 
holds number bits, and at this point these are all Os. 


One may construct from an unsigned long integer value. For example, 


bitset<20> x(39); 


sets x to 00000000000000100111 (the binary representation of 39). 


One may also construct from a C++ string object (these are discussed later 
in Section 14.2). The constructor 


bitset<20> x(string("10110001")); 


sets x to 00000000000010110001. The type string is required; don’t use 
bitset<20> x("10110001"));. 


Finally, a copy constructor is available: 
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bitset<20> y(x); 


makes y a copy of x. Note that x must also be a bit set <20> and may not be 
a bitset of any other size. 


e Inspection methods. These are methods one can use to learn information 
about the bits held in a bitset. Suppose x is a bitset<100>: 
— x.size() returns the number of bits that x holds (in this example, 100). 
— x.any() returns true if at least one bit in x isa 1. 
— x.none() returns true if all of the bits are 0. 
— x.count () returns the number of 1s in x. 
— x.test (k) returns true if the kth bit of x is a 1. Of course, k must be 


at least O and less than x.size(). 


e Bit manipulation methods. The following methods may be used to alter the 
value held in the bits of a bit set. Suppose x is a bitset<100>: 
— x.set () sets all of x’s bits to 1. 
— x.set (k) sets the kth bit to 1. 


— x.set (k,b) sets the kth bit base on the value held in the integer variable 
b. If b is zero, the kth bit of x is set to 0; otherwise it is set to 1. 


— x.reset () sets all of x’s bits to 0. 
— x.reset (k) sets bit k to 0. 


— x.flip() swaps 0 and | values in every position of x. For example, 
suppose x holds 1110001110; after the statement x.flip();, it now 
holds 0001110001. 


— x.flip(k) flips the kth bit of x. 


e Comparison operators. If x and y are both bit sets of the same size, then 
we may compare them with the usual expressions x==y and x!=y. 


e Bit operators. The standard bitwise operators (&, |, *, ~, <<, >>) and their 


assignment variants (&=, |=, “=, ~=, <<=, >>=) may be used on a pair of 
bitsets of the same size. 








e Array style access. In addition to the methods described above, individual 
elements of a bit set may be accessed using square brackets. The expression 
x[k] is the kth element of x. The expression x [k] may appear on the right or 
the left of an assignment statement such as x[4]=~x[10];. 


In addition, the expression x[5].flip() is equivalent to x. flip (5); both 
of these toggle the fifth bit of x. 
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e Input/output. Objects of type bit set can be written to the computer’s screen 
and read from the keyboard. 


The statement cin >> x; reads a sequence of Os and Is from the keyboard. 
At most x.size() bits are read. If fewer bits are read (before reaching a 
character other than 0 or 1), the left bits are filled with zeros. 


The statement cout << x; prints x to the screen. The highest bit (in position 
x.size()-—1) is printed first and the lowest bit, x [0], is printed last. 


Here is a short program that illustrates these ideas. 


#include <bitset> 
#include <iostream> 
using namespace std; 


int main() { 
bitset<1l0> x; 
cout << "Enter bits -> "; 
cin >> x; 


cout << "x = " << x << endl; 
for (int k=0; k<10; k++) { 
cout << "x[" << k << "] = " << x[k] << endl; 


} 


return 0; 


Here is a sample run of this program. 





(ener bits -> 1101 
x = 0000001101 
x[0] = 1 
x[1] = 0 
x[2] = 1 
x[3] = 1 
x[4] = 0 
x[5] = 0 
x[6] = 0 
x[7] = 0 
x[8] = 0 
x[9] = 0 














12.5.4 Class templates with non-type arguments 


We have seen a variety of templates, and in nearly all cases the arguments to 
the template, given between the < and > delimiters, are C++ types. For example, the 
complex class template is completed with a numeric type (e.g., complex<double>) 
and our max_of_three procedure template may use any type arguments that can be 
compared with < (e.g., three PTriple values). 

The exception is the bit set class template. Here, the template is completed by 
specifying an unsigned integer value. How is this done? 

A typical class template is defined in a header file like this: 
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template <class T> 
MyTemplateClass { 


where the data and methods in MyTemplateClass may refer to variables of type T. 
Variables are declared with statements such as this. 


MyTemplateClass<double> x; 


However, the template parameters (the arguments between < and > delimiters) 
need not be classes. For example, we could create a class template such as this: 


template <long N> 
AnotherClass { 


The parameter N may appear in the data and methods of AnotherClass wherever a 
constant long integer might rightly go. For example, AnotherClass might include 
a data member that is an array declared like this: 


private: 
double coordinates|[N]; 


Note that AnotherClass<10> and AnotherClass<11> are different classes (al- 
though based on the same template). 

Template classes may have multiple parameters that may be classes or specific 
values as in this example: 
template <class T, double X, int N, class S> 


ComplicatedClass { 


A declaration based on this template would look like this: 


ComplicatedClass<int, -3.5, 17, double> x; 





12.6 Exercises 


12.1 Exercise 7.3 (page 126) asks you to create a procedure to find the median of a 
list of real (double) numbers. Make a new version that can handle numbers 
of any type by using a template. The procedure should not modify the array. 


12.2 Exercise 11.5 (page 233) asks you to create the class SmartArray that allows 
arbitrary indexing (e.g., a —1 index returns the last element of the array). In 
that problem, a SmartArray contains long integers. Create a new version of 
SmartArray that can hold values of any given type. For example, to declare 
a SmartArray to hold 20 double values, you would type this: 


12.3 
12.4 


12.5 


12.6 


12.7 
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SmartArray<double> X(20); 


Create a derivative procedure that finds the derivative of a Polynomial. 


Create a root-finding procedure for polynomials based on Newton’s method. 
Given a polynomial p and initial guess xo, the procedure should solve p(x) = 0 
using the iteration 

P(xk) 

Pl (x) 

How many iterations should be performed? You may either let the user set the 
number of iterations or a desired tolerance € so that | p(x)| < €. 





Xk+1 = Xk — 


Be sure to address the following issues. 


e The polynomial may be either real or complex. 
e The initial x9 may be either real or complex. 


e The roots might not be simple (i.e., the roots might have multiplicity 
greater than 1). 


The pair class template (defined in the utility header) is a handy mecha- 
nism for creating ordered pairs; see Section 8.5. Using pair as an inspiration, 
create a triple class template that represents an ordered three-tuple (x,y,z) 
where the three elements may be of any type (including different types from 
each other). Make the data fields public and name them first, second, 
and third. 


Remember to define an operator< that orders the triples lexicographically. 


In addition, provide a make_t riple procedure procedure that is analogous to 
make_pair. 


Create a RationalFunction class template to represent rational functions. 
[A rational function is a quotient of two polynomials, p(x) /q(x).] The coeffi- 
cients may be real, complex, or from Z, for some prime p. Include the basic 
operations +, —, x, +. 


Write a program to print out all subsets of the set {1,2,...,}. Do this with an 
integer variable that steps from 0 to 2” — 1 and convert that value into a set. 


Part III 


Topics 


Chapter 13 





Using Other Packages 


Good news! 

The first good news is that we have covered nearly all of the C++ concepts you 
need to know for mathematical work. All that remains is a more extensive discussion 
on getting information in and out of your programs (covered next in Chapter 14). 

The second good news is we are ready to stand on the shoulders of giants. If 
you are reading this book, chances are you are not an expert in computer program- 
ming. So, the next best thing is to have an expert assistant to create C++ classes 
for you. And you do! Thanks to the ubiquity of C++, there are classes available 
for many types of work including number theory, algebraic geometry, optimization, 
quaternions, combinatorics, cup products for finite groups, and more. Many of these 
packages are available for free (for noncommercial use) over the Web. 

In this chapter we introduce a few of these packages. 


13.1 Arbitrary precision arithmetic: The GMP package 


The C++ long type can accommodate integer values in a finite range (see Sec- 
tion 2.1). For work in number theory or cryptography, one needs to handle integers 
with hundreds or thousands of digits. Or perhaps we want to work with rational val- 
ues, but double variables are unacceptable because they do not hold exact values. 
The solution to this problem is to create C++ classes for handling arbitrarily large 
integers and exact rational numbers. 

The creation of such classes takes a lot of work, and making the algorithms effi- 
cient takes a great deal of skill. Fortunately, programmers with a great deal of skill 
have done the hard work of creating the GNU Multiple Precision Library (called 
GMP for short). (We describe version 4.1.4.) 

The GMP library is available on the Web at http: //www.swox.com/gmp/, but 
it may already be available on your computer (it is often included on Linux sys- 
tems). The underlying GMP library is created for programming in C, but it includes 
good support for C++ programming. If GMP has not already been installed on your 
computer, you can download it from the Web and follow the installation instructions 
(see the file install or the manual in PDF format). If you run into trouble, find a 
friendly computer scientist for some assistance. 
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The GMP package provides four important C++ classes: 
e@ mpz_class for arbitrary precision integers, 
e@ mpq_class for exact rational numbers, 
e mpf_class for floating point numbers, and 
® gmp_randclass for generating large random numbers. 


To use these classes, your program needs to include a header file: 


#include <gmpxx.h> 


Variables are declared in the usual manner. For example, to declare x to be an 
arbitrary precision integer, use this: 


mpz_class x; 
This initializes x with the value 0. To give it a large value, the following does not 
work. 


Xx = 3098472938750987439857234543534232626245985; // this fails 


The problem is that C++ is not able to deal with that large value as one of its basic 
types. Instead, you can type this: 


x = "3098472938750987439857234543534232626245985"; // this works 


The mpz_class type can convert character arrays (containing digits). 
The mpz_class can be initialized using other bases. For example, 


mpz_class x("12321423112312321312314001200001213", 5); 


initializes x with a base-5 value. 

The usual arithmetic and comparison operators work just as expected. Multipli- 
cation of extremely large integers is accomplished using sophisticated efficient algo- 
rithms. 


The rational type, moq_class, is constructed either from two integer arguments 


mpq_class a(n_1,n_2); 


or else a character array, such as this: 


mpq_class b("53490875234097/1134381") ; 


Rationals can also be constructed from double values. Indeed, the GMP types can 
be converted to and constructed from nearly any numeric type. 

Rational mpq_class objects have a canonicalize() method. The purpose of 
this method is to clear any common factors between numerator and denominator. It’s 
a good idea to invoke this method after creating an mpq_class value. 





CAHANDUNAPWNKFK TU AANA ADAUN FP WN 


Using Other Packages 271 


The C++ features of the GMP package are a supplement to the C base that forms 
the bulk of GMP. Some GMP procedures require some fancy footwork to be used 
in C++. For example, to find the greatest common divisor of two mpz_class inte- 
gers one uses the procedure mpz_gcd. This procedure takes three arguments of type 
mpz_t—not mpz_class. The mpz_class objects contain an mpz_t type value in- 
ternally and to access that internal value one uses the get_mpz_t () method. Here’s 
how this all works. 

First, we set up our variables: 


mpz_class a = "47825100"; 
mpz_class b = "55431225"; 
mpz_class d; // place to hold the answer 


Then we call the mpz_gcd method like this: 


mpz_gcd(d.get_mpz_t(), a.get_mpz_t(), b.get_mpz_t()); 


Now d holds the gcd of a and b. 


An object of type gmp_randclass is a random number generator. This object 
offers a choice of pseudo random number generator algorithms and allows the user 
to set the seed. For example, to create a new random number generator with a default 
algorithm and seeded from the system clock, we write this: 


gmp_randclass X(gmp_randinit_default); 
X.seed (time (0) ); 


To extract a random value from the generator, we use the get_z_bits method and 
specify the size (in bits) of the result. For example, xX. get_z_bits (100) returns a 
100-bit random integer. 

Here is a program that illustrates these ideas. 





Program 13.1: A program to illustrate the use of the GMP package. 


#include <gmpxx.h> 
#include <iostream> 


using namespace std; 


int main() { 
Mp zanelecisiSuechy melon 


a = "54098745908347598037452"; 
b = "44523409864"; 


cout << "a = " << a << endl; 


Coie << Vey = ) << lo << GSinielils 

cout << "axb = " << axb << endl; 
Souk Ce Vespers ec aye een: 
cout << "a%b = " << a%b << endl; 
@ouie «<< Verde = ll Ke SHO) KS Siguclilp 
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injova_ielleusis! lp 


mozeedia cetimps tt (), a.ger mpz tly bgSst mp2 Oy 
Comic << VWejec(eis) = “ «<< cl << Giaclie 
Crouse << Vans ey << iloye W <<< (Cecio “2 Mawes 6 MINI) 6 


cout << endl; 


mpq_class r(a,b); 
r.canonicalize(); 


Gow << WAS gy seaicsi@iaa sh inmiloyare, eiey ais YU << ie << Gisiolil p 


iiec_rellewss, @F(=il , 12S) 3 
copie << Yep W ax Ci << Ginclils 


gmp_randclass X(gmp_randinit_default) ; 
X.seed(time(0)); 


cout << "Here’s a random number: " << X.get_z_bits(100) << endl; 


return 0; 





Compiling this program can be tricky. The computer needs to find the following 
items, 


e The header file gmpxx.h, and 
e The libraries! gmp and gmpxx. 


If the GMP header files are installed in a standard location, no special steps are 
required for the compiler to locate the header file gmpxx.h. No special steps are 
needed if the file gmpxx.h resides in the same directory (folder) as the program that 
#includes it. Otherwise, the compiler needs to be informed of the header file’s 
location. The precise manner in which this is done can vary between compilers. For 
example, with the g++ compiler (a popular choice), one specifies the directory in 
which gmpxx.h resides with the -I command line option. (See the full example 
below as well as Appendix A.) 

It is also necessary to tell the compiler to use the libraries gmp and gmpxx (these 
are distinct from the header file gmp .h). For example, with the g++ compiler, this is 
accomplished with a pair of -1 command line options (see below). In the case where 
these libraries are installed in a nonstandard location, it may be necessary to tell the 
computer where to find these libraries. This is accomplished with the -L command 
line option in g++. 

For example, to compile the gmp-tester.cc program (Program 13.1) above, I 
use the following command, 


g++ gmp-tester.cc -I/sw/include -L/sw/lib -lgmp —lgmpxx 


'A library contains compiled code needed by the GMP package. 
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On my computer, the gmpxx.h header file is in the directory /sw/include (spec- 
ified by the -I option), the libraries are located in /sw/1ib (specified by the -L 
option), and the gmp and gmpxx libraries are named explicitly (by the pair of -1 
options). 


Here is the output of the program. 








a = 54098745908347598037452 

b = 44523409864 

axb = 2408660637205753086401397418226528 

a/b = 1215062953929 

aSb = 4181881796 

atb = 54098745908392121447316 

a-b = 54098745908303074627588 

b-a = —54098745908303074627588 

gcd(a,b) = 4 

Is a < b? No 

As a rational number, a/b is 13524686477086899509363/11130852466 
q = -9/8 

Here’s a random number: 521322704085186435455013754888 








13.2 Linear algebra 
13.2.1 Two-dimensional arrays in C++ 


One-dimensional arrays in C++ are mildly difficult to use. One needs either to give 
the explicit size of the array in advance (e.g., long vals[10];) or else to declare 
the array via a pointer (long «vals;), allocate space (vals = new long[n];), 
and then release the memory when finished (delete[] vals;). We need to re- 
member that the first element of an array is indexed as vals[0] and there is no 
protection against accessing data beyond the bounds of the array. There is no conve- 
nient way to extend the size of the array. The vector class template solves many of 
these problems. 

It is possible to use multidimensional arrays in C++, but the difficulties are com- 
pounded. We describe such arrays here briefly in order to convince you that you do 
not want to use these tricky structures and, instead, will avail yourself of some of the 
options we discuss below. 

To declare a two-dimensional array of a given size, we use a statement such as 
this: 
long vals[4][10]; 


This establishes a variable named vals as a 4 x 10-array of long integer values. 
Please note that the following statement is incorrect: long vals[4,10];. Unfor- 
tunately, it is valid C++ (don’t bother trying to figure out what it does) so the compiler 
won’t catch this error. 
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To access an element of this array, we use the syntax vals[i] [3] where i is 
between 0 and 3, and 5 is between 0 and 9. The expression vals [i, 3] is incorrect. 
It is possible to declare three- (or higher-) dimensional arrays. For example, 


long vals[4][10] [19]; 


declares vals to be a4 x 10 x 19-array of Long values. The i, j,k-entry of this array 
is given by vals[i] [3] [k] where i, j,k have the expected constraints. 

Passing multidimensional arrays to procedures is possible, but the syntax is tricky. 
Procedures that receive such arrays need to specify the size of the array they expect 
to receive. 

Fortunately, there are better alternatives. The two that we present have the added 
advantage of providing linear algebraic capabilities (matrix multiplication, eigen- 
value calculation, etc.). 


13.2.2 The TNT and JAMA packages 


The U.S. government’s National Institute of Standards and Technology (NIST) 
has created a pair of packages for working with one-, two-, and three-dimensional 
arrays and to perform standard linear algebra functions thereon. The packages are 
the Template Numerical Toolkit (TNT) and the C++ Java Matrix Library (JAMA).” 
These are available for free download from the following Web site, 


http://math.nist.gov/tnt/index.html 


You need to download the TNT and JAMA packages separately. Be sure to download 
the documentation as well; this consists of a collection of Web pages that describe 
the various classes and procedures. (We describe TNT version 1.2.4 and JAMA 
version 1.2.2.) 

Installation is easy because these packages are simply collections of .h header 
files. They can be copied to any convenient location on your computer (including, 
e.g., the directory containing your program that uses these files). 

The most important classes in the TNT package are Array1D (for vectors) and 
Array2D (for matrices*). To use these, we need the directive #include "tnt.h" 
and the statement using namespace TNT; at the beginning of our program. The 
classes and procedures in the TNT class are in their own namespace. If we did not 
use this statement, then we would need to prepend TNT:: to the names of TNT 
classes and procedures (e.g., TNT: : Array2D in lieu of Array2D). 

To declare an array of elements of type, say, double, we use statements like 
these: 

Array2D<double> M(5,10); 


ArraylD<double> v(9); 
Array2D<double> X; 


?This library was developed first for the Java programming language and subsequently ported to C++. 
3-You may discover that the TNT package includes classes called Mat rix and Vector. Do not use these. 
They are deprecated classes; this means they are obsolete and their inclusion in the package is only to 
support people who used older versions of TNT. 
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Here, Mis a5 x 10-array (matrix) of double values, v is a length-9 array (vector), 
and X is an as-yet unsized matrix. 

To access elements of an array we use the usual C++ conventions. For the variables 
Mand v above, the syntax is as follows, 


@ M[{i] [3] whereO <i<5and0 <j < 10, and 
e v[k] whereO<k <9. 


To learn the size of an array, the methods dim1() and dim2 () give the number of 
rows and columns (if more than one-dimensional) in the array. 


Read this carefully: The assignment operator for TNT array classes (e.g., B=A; ) 
works in a manner that is different from other classes we have encountered thus 
far. After this assignment not only are A and B arrays of the same size and not 
only do they hold the same values, they now refer to the exact same data. In other 
words, modifications to one of A or B results in change in the other. (We say that A 
and B provide different views to the same underlying data.) If we wish to make an 
independent copy of A in B, we need to use the copy method like this: 


B = A.copy(); 


Here is a program that illustrates the difference between the statements B=A; and 
B=A.copy();. 





Program 13.2: Assignment versus copying in the TNT package. 


#include <iostream> 
#include "tnt.h" 


using namespace std; 
using namespace TNT; 


int main() { 
Array2D<double> A(3,3), B, C; 


Oe (Guiate aSOp G<Ss. siapap)) 
for (int j=0; 3<3; j++) 
AMAT al = (ari) ae Ocihe (april) 9 


Count so TOriginal metrix As” “<< Sridl) << fA) <5 endl; 


B =A; // Now B and A share data 
C = A.copy(); // C is an independent copy of a 
rk {pab | [babi <S* feileitshe 


NIOLAL = QOO-r 


Coutts <<) “NOW. Anis thas. << sendin << Ac ends 
Gone << Weal 18) ae ielakey 1 << teinellh << je} K< Giovelils 
Gone «K< Weracl © ae iclke, << emell << © «K< Girlie 


return 0; 
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Here is the output of the program. 








Original matrix A: 
3-3 
cee a ee cae ens 
lL Lak Bae 
Cae Pac 


Wn 
WwW 








3 

Und Deke 29s 

2 888 2.3 

3 342: °3.3 
and C is this 
3.3 

Ls A 2 LS 
24d 2.2 293 
Sed See wae 





Dd, 





(Notice that Array2D objects can be written to the computer’s screen using the usual 
<< operator. The first line of output is a pair of integers giving the number of rows 
and columns; the array follows one row at a time.) 

One implication of this unusual assignment operator behavior is that when TNT 
arrays are passed to procedures, the procedure does not receive an independent copy. 
Suppose we have a procedure that looks like this: 


void proc(Array2D<double> X) { ... } 


It appears that this procedure is ready to receive its argument using call by value. 
From this we might infer (incorrectly) that if proc modifies x, there would be no 
effect on the matrix sent to this procedure. However, because assignment does not 
make a true copy (but only an alternative view of the same data), modifications do 
cause changes in the array on which this procedure was invoked. 

The solution to this issue is simple: Do not use call by value for TNT arrays. 
This is a good practice in general because sending large objects as parameters of 
procedures is inefficient. Instead, use call by reference, and include the keyword 
const when you need to certify that the procedure does not modify its argument. 
Thus, the procedure should look like this: 


void proc(const Array2D<double>& X) { ... } 


Alternatively, if your procedure is not limited to arrays of double values but may be 
used on a broader assortment of types, use a template: 


template <class T> 
void proc(const Array2D<T>& X { ... } 
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For example, here is a header file named t race .h that provides a template proce- 
dure to calculate the trace of an Array2D matrix: 





Program 13.3: A template to calculate the trace of an Array2D matrix. 


#ifndef TRACE_H 
#define TRACE_H 


#include "tnt.h" 


template <class T> 
T trace(const TNT::Array2D<T>& X) { 
T sum = T(0); 
toe (Guan k=O ikoxcveliml () we KkKoO< clini ()p Sear) tf 
sum += X[k] [k]; 
} 
return sum; 


} 


fendif 





The TNT package provides rudimentary array arithmetic. If A and B are arrays of 
the same type and same size (e.g., both Array2D<long> and both m x n) then the 
following operations are available. 


A+B At+=B A-B A-=B AxB A*x=B A/B A/=B 


In each case, the arithmetic is performed element by element. If A, B, and Cc are 
Array2D<double> objects, and if A and B are the same size (both m x n), then 
C=AxB; sets C to be an m X n-array in which C[i] [3] is A[i] [3]*Bli] [3]. Itis 
not matrix multiplication. 

Matrix multiplication is available via the matmult procedure. Matrix multipli- 
cation can only be performed on Array2D arrays of the appropriate shapes. The 
statement C = matmult (A,B); sets C to the appropriate size (if A is m x n and B is 
nx p, then C is m x p) and sets the elements of C appropriately: 


n—1 
Clil(j] = y Afi] [kK] *B[k] [9] 
k=0 


The TNT package does not provide scalar multiplication of arrays, nor does it 
provide matrix—vector (Array2D times Array1D) multiplication. However, it is not 
difficult to create template procedures to perform these tasks. For example, here is a 
template for scalar—vector multiplication. 


#include "tnt.h" 
using namespace TNT; 
template <class T> 
void scalar_vector_multiply(T s, 
const Arrayl1D<T>& vec, 
Arrayl1D<T>& ans) { 
ans = ArraylD<T>(vec.diml()); // resize ans 
for (int i=0; i<vec.diml(); ++i) { 
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More advanced linear algebra functions for real matrices are provided by the 
JAMA package. This package provides the following classes: 


JAMA: : Cholesky — Given areal, symmetric, positive definite matrix A, find 
a lower triangular matrix L so that A = LL’. Header file: jama_cholesky.h. 


JAMA: :Eigenvalue — Given a real, square matrix A find the eigenvalues 
and eigenvectors of A. If these are complex, the real and imaginary parts of the 
eigenvalues are accessed separately. (This class does not use the complex<> 
types.) Header file: jama_eig-h. 





JAMA: : LU — Given a real, m x n-matrix (with m > n) A, find a lower triangu- 
lar matrix LZ and an upper triangular matrix U so that LU is a (row permutation 
of) A. Header file: jama_lu.h. 


JAMA: :QR — Given a real, m x n-matrix (with m > n) A, find an m x n orthog- 
onal matrix Q and an n x n upper triangular matrix R so that A = QR. Header 
file: jama_qr.h. 


JAMA: :SVD — Given a real, m xn matrix A (with m > n), find anmxn 
orthogonal matrix U, an n x n diagonal matrix ©, and an n Xx n orthogonal 
matrix V so that A = ULV". Header file: jama_svd.h. 


The design philosophy for all these classes is the same. To find, say, the eigenval- 
ues of a matrix A, we do not use a procedure to which A is passed. Instead, we create 
a JAMA: :Eigenvalue object like this: 





#include "tnt.h" 
#include "jama_eig.h" 
using namespace TNT; 
using namespace JAMA; 


int main() { 
Array2D<double> A(10,10); 


} 


// 


assign values to the elements of A 


Eigenvalue<double> eigs (A); 


This code loads the necessary headers and sets up a matrix A. We then create an 





Eigenvalue object named eigs. The matrix A is passed to the constructor. 





The eigenvalues and eigenvectors are now embedded inside the Eigenvalue ob- 
ject named eigs. To extract the information we use one of the access methods 
provided by the Eigenvalue class: 
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e eigs.getRealEigenvalues() returns an Array1D object containing the 
real parts of the matrix’s eigenvalues. 








e eigs.getImagEigenvalues() returns an Array1D object containing the 
imaginary parts of the eigenvalues. 


e eigs.getV() returns an Array2D (matrix) whose columns contain the eigen- 
vectors of the matrix. (Refer to the documentation to see how Eigenvalue 
handles complex eigenvectors.) 





There are other linear algebraic entities one might like to compute including the 
rank or determinant of a matrix, or the solution to the linear system Ax = b. The 
JAMA package provides tools for doing this. To find them, one needs to browse the 
documentation for the various classes (Cholesky, Eigenvalue, etc.), but it’s not 
too hard to guess where these might lie. Some examples: 


e To find the determinant of a matrix: It’s easy to find the determinant of a 
matrix from its LU-factorization. Naturally enough, the Lu class includes a 
det () method. For example, if A is a square, Array2D<double> matrix, the 
following code finds its determinant, 


LU alu(A); 
cout << "The determinant of A is " << alu.det() << endl; 


e To solve a linear system Ax = b: Again, this is often found through the LU- 
factorization, and the LU class contains two solve () methods: one that solves 
Ax = b and another that solves AX = B (where x and b are vectors, and X and 
B are matrices). 


The OR class also provides solve () methods; if the system is overdetermined, 
this solve gives a least-squares solution. 


In the special case that A is symmetric and positive definite, a solution to the 
linear system can also be found through the Cholesky factorization. The class 
Cholesky has a method named is_spd() to check if a matrix is symmet- 
ric and positive definite, and a pair of solve () methods for solving linear 
systems. 


Generally, it is numerically unwise to solve Ax = b by inverting A and calcu- 
lating A~'b. However, if we wish to find the inverse of a square matrix A, we 
can create an identity matrix J and solve AX = I. 


See the documentation for details. 
e To find the rank of a matrix: The rank of A is the number of nonzero singular 
values. So, to find the rank of a matrix, use the SVD class’s rank () method: 


Array2D<double> A; 


SVD sing_vals (A); 
cout << "The rank of A is " << sing_vals.rank() << endl; 
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The calculation of the rank of a matrix is difficult if the matrix is ill condi- 
tioned. To check a matrix’s condition number, use the cond() method, also 
found in the SvD class. 


We illustrate the use of the TNT and JAMA packages with the following program. 
Recall that a Hilbert matrix is an n x n-matrix whose i, j-entry is 1/(i+j—1) (in 
the usual notation in which the upper left corner contains the 1, 1-entry). Hilbert 
matrices are invertible, but notoriously ill conditioned. Hence, finding their inverses 
is numerically unstable. The following program creates a Hilbert matrix (whose size 
is specified by the user), finds its inverse from its LU-factorization, calculates its 
eigenvalues, and (because Hilbert matrices are symmetric and positive definite) finds 
its Cholesky factorization. 





Program 13.4: A program to illustrate the TNT and JAMA packages with calcula- 
tions on a Hilbert matrix. 


#include "tnt.h" 

#include "jama_lu.h" 
#include "jama_eig.h" 
#include "jama_cholesky.h" 
#include <iostream> 

using namespace std; 

using namespace TNT; 

using namespace JAMA; 


// A program to demonstrate the use of TNT and JAMA packages for 
// linear algebra work. 


int main() { 
// Get the size of the matrix from the user 
Gere << Wihshesue Ishiilesuete, iieligieab< pyalGr ——S> We 
IME jag 


Gili SS ing 


ab On ere Pony 
cerr << "Please enter a value greater than 1" << endl; 
return 1; 


I 


// H holds the n-by-n Hilbert matrix and eye holds the n-by-n 
// identity matrix. 

Array2D<double> H(n,n); 

Array2D<double> eye(n,n); 


// Fill in the entries in H 
woe (Guae sSOPp aces aier)) ff 
w@e (Gloie FOR qeap ape) t 
BL all Sth f (alte aari) ¢ 


// Set up identity matrix 
for(int. TOF Tene eer eve ia pa) 


Il 
jen 


w 
‘oO 





K 
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Ye RCL. CUb. A 
come «<< Viel VY << ciaclile 
Gomi KK il << Sievelilg 


// Use the LU decomposition’s solve method to find the inverse of H. 
LU<double> HLU(H); 

Array2D<double> Hinv = HLU.solve (eye) ; 

Coue <= VHesinvenses — ala <<sencdily;) 

GOs << ilaiohwAe< vehevelilg 


// Use the LU decomposition of H to calculate its determinant 
cout << "The determinant of H is " << HLU.det() << endl; 


// Use the Eigenvalue class to find the eigenvalues of H 
Eigenvalue<double> Heig(H); 

cout << "The eigenvalues of H are " << endl; 
ArraylD<double> eig_vals; 

Heig.getRealEBigenvalues (eig_vals) ; 

Ole (Aves alSOp aik<eip fichse)) C@wle K< Cine) ayes a) << We We 

cout << endl << endl; 








// Use the Cholesky class to find a matrix C so that CxC’ = H 
Cholesky<double> Hchol (H) ; 

Array2D<double> C = Hchol.getL(); 

Sout. << The Cholesky matrix £67 has " <<“endl; 

come <<< © << Girelils 


// Construct C’s transpose 
Array2D<double> Ctrans (n,n); 
ie@ue ((iuaye T= 0)e sis<iel\@ icrar)) 4 
woe (loie FOR ag are) 
Circassia = Cs tule 


// Check that C*C’ gives H 
Cou << VG Ae? = VY << Ginieliks 
COU KK incendie (Cp Cireeinsy)) << Siorelilp 


return 0; 





Here is the output of a typical run. 








Enter Hilbert matrix size --> 5 

H= 

5225 

T 10..'5; 05333333. 07257 0.2 

0.5 0.333333 0.25 0.2 0.166667 
0.333333 0.25.0.2 0.166667 0.142857 
0.25 0.2 0.166667 0.142857 0.125 

0.2 0.166667 0.142857 0.125 0.111111 


H inverse = 
S56 
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25 -300 1050 -1400 630 

-300 4800 -18900 26880 -12600 

050 -18900 79380 -117600 56700 
-1400 26880 -117600 179200 -88200 
630 -12600 56700 -88200 44100 


The determinant of H is 3.7493e-12 

The eigenvalues of H are 

3.28793e-06 0.000305898 0.0114075 0.208534 1.56705 
The Cholesky matrix for H is 

S.-5 

0000 

0.5 0.288675 0.0.0 

-333333 0.288675 0.0745356 0 0 

-25 0.259808 0.111803 0.0188982 0 

-2 0.23094 0.127775 0.0377964 0.0047619 





| i Ee 


cl = 


C x 
S85 
1. -0%:5, 0:333333> 0.250. 2 

0.5 0.333333 0.25 0.2 0.166667 
0.333333 0.25 0.2 0.166667 0.142857 
0.25 0.2 0.166667 0.142857 0.125 

0.2 0.166667 0.142857 0.125 0.111111 





13.2.3. The newmat package 


Another package designed specifically for linear algebra is the newmat package. 
This package was developed by Robert Davies and is available for free from his Web 
site, http: //www.robertnz.net/. (We describe version 11, beta.) 

This package needs to be compiled on your computer; the instructions on how to 
do this are included in the download. Once compiled, you will find a library (named 
libnewmat.a, or something similar) and several .h header files. You may copy 
these to another location if you desire. 

All programs that use the newmat package need a #include "newmat.h" di- 
rective. If the program requires more than the basic features of the package, other 
headers may need to be included. For example, to use << to print matrices to cout, 
be sure to include the newmat io.h header. 

When you compile your own program, you need to tell the compiler where to 
find the header files (e.g., with the -I option), where to find the library (e.g., with 
the -L option), and to link with the newmat library (e.g., with -1newmat). See 
Appendix A.1.4 for more information about the -L and -1 options. 


The newmat package provides several different classes for holding matrices; in 
all cases, the matrices hold double real values.* The fundamental matrix type is 


“It is possible to switch this to float values if you prefer. 
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called Matrix and its constructor takes two arguments giving the number of rows 
and columns. Here is an example, 


Matrix A(2,3); 


Now A is a2 X 3-matrix. It is also possible to declare a matrix without specifying its 
size, for example, Matrix A;. 

Elements of a matrix are specified using the standard mathematical convention: 
the element in row i and column 5 of a matrix Ais A(i, 4). Here, i (respectively, 
3) is at least 1 and at most the number of rows (respectively, columns) of A. The 
expression A(i, 3) may appear on either side of an assignment. (It is also possible 
to have newmat use the C++ multidimensional array notation A[i] [3] in which 
case the subscripts begin at zero, but this is not recommended.) 

The Matrix constructor does not specify values for its elements; it is the pro- 
grammer’s responsibility to handle that. So, for example, to create a 10 x 5-matrix 
of zeros, do this: 


Matrix 2(10,5); 
Z= 0.; 


In addition to Matrix, the newmat package provides several other classes for 
holding matrices including the following, 


SquareMatrix, 
UpperTriangularMatrix, 
LowerTriangularMatrix, 
SymmetricMatrix, 
DiagonalMatrix, 
IdentityMatrix, 


and various banded matrices. For vectors, the package provides columnVector and 
RowVector. These alternatives use the computer’s memory efficiently. In addition, 
some procedures require specific types of matrices. For example, the Eigenvalues 
procedure may only be used on symmetric matrices and the eigenvalues are returned 
in a diagonal matrix: 
SymmetricMatrix A(n); // n-by-n symmetric matrix 

// load values into A 


DiagonalMatrix D; // place to hold the eigenvalues 
EigenValues (A,D) ; // find the eigenvalues of A 


The Symmet ricMat rix class is clever about assigning values to elements. Con- 
sider this code. 


#include <iostream> 
#include "newmat.h" 
#include "newmatio.h" 
using namespace std; 


int main() { 
SymmetricMatrix A(3); 
A(1,2) = 3; 
A(3,2) = 2; 


cout << A << endl; 
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return 0; 


} 


(Note: The inclusion of the iost ream header must precede the newmat io.h header.) 
The output of this program is this. 





0.000000 3.000000 0.000000 
3.000000 0.000000 2.000000 
0.000000 2.000000 0.000000 





Because A is symmetric, setting A(i, 3) to some value automatically sets A(j,i) to 
the same value as well. 


The newmat packages provide a rich assortment of matrix operations. Here is a 
brief description of some of them. 











B=A; Make a copy of A in B. 
A.t() Return the transpose of A. 
A.i() Return the inverse of A. 





A+B, A+=B; | Matrix addition. 

A-B, A-=B; | Matrix subtraction. 

A*B, Ax=B; | Matrix multiplication. 

A|B, A|=B; | Horizontal concatenation. 

A&B, A&=B; | Vertical concatenation. 
==B, A!=B | Equality/inequality testing. 





























Considerable care was taken in designing these operations. For example, to solve 
the linear system Ax = b, the statement x = A.i() »* b; does not invert the matrix, 
but finds the solution by a better method. However, if A and B are n x n-matrices and x 
is an n-vector, the expression Ax (B*x) evaluates much more quickly than (A*B) +x. 
If you type the ambiguous A+B» x it is not clear in what order the computer does the 
calculation. 

Scalar—matrix calculations (including scalar—vector) behave as you might expect. 
If s is type double and A is type Matrix, then A+s (or s+A) gives a new matrix 
whose i, j entry is A(i, 43)+s. The statement A+=s; adds the value in s to all the 
elements in A. The operations -, *, and / behave analogously. 

The nrows() and ncols() methods give the number of rows and columns, re- 
spectively, of a matrix. There is a variety of methods for modifying the shape (and 
type) of a matrix including ReSize(), AsColumn(), AsRow(), AsDiagonal(), 
and so on. These are spelled out in the documentation. 

The newmat package provides a rich assortment of procedures for important linear 
algebraic problems including: Cholesky factorization of symmetric matrices, QR- 
factorization, singular value decomposition, symmetric matrix eigenvalue decompo- 
sition, fast Fourier (and other trigonometric) transforms, determinant, trace, various 
matrix norms, dot product of vectors, and so on. 

To illustrate some of these, here is a program that finds the determinant, trace, 
eigenvalues, and inverse of a Hilbert matrix (compare with Program 13.4). 
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Program 13.5: A program to illustrate the newmat package with calculations on a 
Hilbert matrix. 


#include <iostream> 
#include "newmat.h" 
#include "newmatio.h" 
#include "newmatap.h" 


using namespace std; 


aiipte: iqaysysiial(()) 4 
Cowles << Wihinicere sale Wis ishlWosiee, iieicicilb, = ls 
ALE aig 
Calin SS iste 


SymmetricMatrix H(n); 
ore (Guae Sip a<Sine ater) 4 
igoye (Guidi) Sale j<Siap aae)) 
jal (ak 9) = Ie 7 Clotlolke((aergj=i))p 


} 


Come <<— “Wee ies Woeicic ies as VY << Sincll, << i << Ginyelilp 
come << Vites elec as Y << iis peicemmiimeime()) << @iaxelils 
Goue «<< Wines) abenisiesie: ats 1 <<< Gigvelll «<< isigal(()) << <exovelile 


DiagonalMatrix D; 
EigenValues (H,D); 


cout << "The eigenvalues of the Hilbert matrix are" << endl; 
Gome << DW) << eiovelilg 


cout << "Trace calculated two ways: " << H.Trace() << " and " 
<< D.Trace() << endl; 


return 0; 





Here is an output of the program in which the user specifies a Hilbert matrix of 
size 5. 








Enter size of Hilbert matrix --> 5 
The Hilbert matrix is 


1.000000 0.500000 0.333333 0.250000 0.200000 
0.500000 0.333333 0.250000 0.200000 0.166667 
0.333333 0.250000 0.200000 0.166667 0.142857 
0.250000 0.200000 0.166667 0.142857 0.125000 
0.200000 0.166667 0.142857 0.125000 0.111111 


Its det is 3.7493e-12 

Its inverse is 

25.000000 -300.000000 1050.000000 -1400.000000 630.000000 
-300.000000 4800.000000 -18900.000000 26880.000000 -12600.000000 
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1050.000000 -18900.000000 79380.000000 -117600.000000 56700.000000 
-1400.000000 26880.000000 -117600.000000 179200.000000 -88200.000000 
630.000000 -12600.000000 56700.000000 -88200.000000 44100.000000 


The eigenvalues of the Hilbert matrix are 
0.000003 
0.000306 
0.011407 
0.208534 
1.567051 


Trace calculated two ways: 1.7873 and 1.7873 








13.3. Other packages 


There are many more packages available on the Web than we can possibly describe 
in detail. We conclude this chapter by listing a few additional packages that might 
be of interest. A well-chosen selection of keywords typed in a search engine is likely 
to turn up additional options. 


e Seldon is a full-feature linear algebra package, available for free online here: 
http://www.osl.iu.edu/research/mt1/ 

e The Matrix Template Library is another package for working with matrices. 
Visit the Web site for more information and a free download: 
http://www.osl.iu.edu/research/mt1/ 

e The Computational Geometry Algorithms Library or CGAL for short is a large 


library of C++ classes and procedures for geometry work. Use it to find every- 
thing from convex hulls to Voronoi diagrams to minimum enclosing ellipses. 


CGAL is available for free from www. cgal.org. 


e For graph theory work, try Boost, available for free from www. boost .org. 


Read the installation instructions carefully. The first step is to build a helper 
program called bjam that is used to direct the building of boost itself. 


e For computational number theory, consider LiDIA. Based on the GMP package 
(see Section 13.1), it gives programmers the ability to do calculations in finite 
fields and on elliptic curves, use lattice reduction algorithms, perform linear 
algebra calculations, and more. It is available for free: 


http://www.informatik.tu-darmstadt.de/TI/LiDIA/ 
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The Library of Efficient Data Structures and Algorithms, also known as LEDA, 
is a commercial package for work in graph theory, geometry, cryptography, 
and more. More information, including pricing, is available here: 


http://www.algorithmic-solutions.com/enleda.htm 
Interested in computing the homology group (over Z or Z,) of a chain com- 
plex? Consider the C++ software available from CHomP—the Computational 


Homology Program. See their Web site for more information and a free down- 
load: 


http://www.math.gatech.edu/~ chom/ 





13.4 Exercises 


13.1 


13.2 


The base ten representation of 100! ends with a long string of zeros; it is a 
classic problem to find how many. Solve this problem with C++ using the 
GMP package. 


Write a program that fills a two-dimensional array with Pascal’s triangle. That 
is, the n,k-entry is (7). [If n <k, set (7) =0.] Build the table to include 
rows/columns 0 through 20. Generate each row from the previous row using 


the identity (7) = (ea) + (aes 
What modification to your program would be necessary were you to increase 
the size of the table to 100 x 100? 


Chapter 14 





Strings, Input/Output, and Visualization 


For the most part, mathematical work does not involve manipulation of character 
data. Nonetheless, it is useful to have a general understanding of how C++ handles 
character data, how to convert text to numbers, how to use command line arguments, 
and how to read and write data in files. We also show how to modify the formatting 
of output (e.g., how to increase the number of digits printed after the decimal point). 
We illustrate many of these ideas by creating a class to parse files one line at a time, 
and break those lines into individual words. 

C++ has two ways to handle character data: arrays of char values and in objects 
of type string. The char arrays are a legacy of C++’s roots in the C programming 
language. It is necessary to understand their basics, but their use should be avoided 
where possible. The newer st ring variables are easier to use. We begin with a brief 
introduction to char arrays. 

Textual and numerical output are important, but there are times when graphical 
output is especially insightful. We close this chapter with a discussion of how to 
draw pictures in C++. 





14.1. Character arrays 


Character (or text) data consist either of individual characters (letters, numerals, 
punctuation) or of lists of characters. The C++ data type char holds a single char- 
acter from the Latin character set (26 lower- and uppercase letters, numerals, white 
space, punctuation). These are known as the ASCII characters and are the only char- 
acters with which this book deals. Computers can also deal with a richer set of 
glyphs (from accented Latin letters to Chinese characters) using a system called uni- 
code; this system is beyond our scope. 

An ordered list of characters is generally called a character string. For example, 
the words Hello Gauss are such a list comprising 11 characters. As mentioned, 
C++ has two principal ways to work with character strings: as null-terminated char 
arrays and as objects of the class string. The character array representation is a 
primitive scheme inherited from the language C-. It is useful for writing messages to 
the screen and other simple chores. The moment one wishes to do any manipulation 
of characters (e.g., concatenate two strings), the C++ string class makes program- 
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ming much easier. We begin by discussing the basics of character arrays and then 
introduce the string class in the next section. 


In a statement such as cout<<"The answer is "<<x<<endl1;, the characters 
enclosed in quotation marks form a character array. That is, the sequence of letters 
is a C++ object of type char»: an array whose elements are type char. 

In this book we have used character arrays exclusively for writing messages to the 
computer’s screen, but it is possible to hold such arrays in variables. For example: 


const char* word = "Hello"; 


This creates an array of characters named word. The individual characters can be 
accessed using the usual array notation. For example, word[0] is the first character 
of the array, that is, H. 

It is surprising to learn that the length! of the array word (as declared above) 
is six (even though Hello is a five-letter word). Character arrays in C++ are null 
terminated; this means that after the last character of the string, the numerical value 
0 is appended to mark the end of the string. Figure 14.1 illustrates how the contents of 
the variable word are stored inside the computer’s memory. The array is held at some 





word 


| 


20320 20321 20322 20323 20324 20325 


72/101 108 | 108 111 0 


He 1 Lo 





























Figure 14.1: Illustrating a null-terminated character array. 





location in memory (arbitrarily set at 20320 in the figure); the variable word holds 
that memory location. The elements of the array, word[0] through word[5], are 
stored as ASCII values. The letter H has ASCII value 72, hence that’s what is stored 
in word[0]. The subsequent values are 101, 108, 108, and 111 corresponding to the 
letters e, 1,1, and o. Finally, word [5] contains the numerical value 0 (which does not 
correspond to any printable character) and this marks the end of the character array. 
There are procedures for processing character array data; here are a few examples. 


e strlen gives the length of the character string (not including the terminating 


0). 


'The length of the character string is 5, but the length of the array that supports that string is 6. The C/C++ 
procedure st rlen applied to the character array "He11o" returns the value 5. 
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e strcpy and strncpy are used for copying one character array to another. 


e strcat and strncat are used to concatenate two character arrays; that is, if 
sl is "Good" and s2 is "Morning", their concatenation is "GoodMorning". 


e strcmp and strncmp give a total ordering on the set of character arrays; this 
is useful for sorting a list of character strings or determining if two strings are 
equal. 


On some compilers, you may need the directive #include <cstring> in order to 
use these procedures. 

Using character arrays and their associated procedures is awkward and error prone. 
In nearly all cases, it is much simpler to use the C++ st ring class instead. So, rather 
than delve into the details of these procedures, we turn to the friendlier and more 
powerful st ring class. 





14.2. The string class 


For any character processing tasks beyond the most basic, use C++’s string 
class. To use string objects, you might need the directive #include <string> 
(the header is optional with some compilers). 

The string class contains a large number of features; in this section we discuss 
those with the greatest utility in mathematical work. 


14.2.1 Initialization 


Variables of type st ring can be declared in several ways; here are the most basic 
versions: 


e string s; declares s to be an empty character string. 


e string s("Hello"); declares s to be a character string containing the let- 
ters Hello. In lieu of "Hello" we can use any null-terminated character 
array, such as this: 


const char*x word = "Gauss"; 
string s(word); 


Please note: It is not permissible to use a single char value as an argument 
to a string constructor. Thus, string s(’j’); is illegal. Instead, use 
string s("j");. Alternatively, the following is permissible. 


string s; 
s = 'j'’; // this is OK 
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e string s(s2); initializes s with a copy of the string s2. 


e string s(s2, idx) ; initializes s with a copy of the portion of string s2 that 
starts at position idx. 


e string s(s2,idx,len); initializes s with a copy of the portion of string 
s2 that starts at position idx and runs for len characters. For example, 


string s("Mathematics"); 
String. t.(s7:25.3) 3 
cout << t << endl; 


writes the word the on the computer’s screen. Note that the Oth character of 
sis M. 


e string s(reps, ch); where ch is a character and reps is a nonnegative 
integer. This initializes s with reps copies of the character ch. For example, 
string snore(10,’z’); 
cout << z << endl; 


writes zzzzzzzzzz on the screen. 


In addition to setting a string’s value when it is declared, we may modify its 
value using an assignment statement such as any of these: 


= "Gauss"; 
s = 'Qg'; 
s = other; // other is another string object 


14.2.2 Fundamental operations 


The most basic operation one can perform on st ring objects is concatenation; the 
result of concatenating strings s1 and s2 is a new string comprising the characters 
of s1 immediately followed by the characters in s2. Concatenation of strings in 
C++ is denoted by the addition operator, +. For example, consider this code: 
string sl("Hello "); 


string s2("Gauss"); 
cout << sl+s2 << endl; 


This prints Hello Gauss on the computer’s screen. The + operation can be used 
to combine strings with single characters or with character arrays. Here are some 
examples. 


string s("Hello"); 


cout << s + " Gauss" << endl; // writes "Hello Gauss" 
string sl = "good"; 
string s2 = "luck"; 


cout << sl +’ '’ + s2 << endl; // writes "good luck" 


One string can be appended to the end of another using the += operation: 
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string s("Carl Friedrich"); 

SSP he // append a space 

s += "Gauss"; // append the last name 
cout << s << endl; 


writes Carl Friedrich Gauss on the screen. 


Characters may be inserted into the middle of a string using the insert method. 
The statement s.insert (pos,t) ; inserts the string t into s just before character 
s[pos]. The statement s.insert (0,t); inserts the characters at the beginning of 
s. Here is an example. 


string s("CarlGauss"); 
s.insert (4," Friedrich "); 
cout << s << endl; 


writes Carl Friedrich Gauss on the screen. 
In the statement s. insert (pos,t) ; the variable t may be either a string ora 
character array. It may not be type char. 


s.insert (3,"x"); // allowed 
s.insert (3,’x’); // forbidden 


The erase method is used for deleting characters from a string. The statement 
s.erase (pos); deletes all characters from position pos to the end of the string. 
For example, 


string s = "abcdefghijklmnopqrstuvwxyz"; 
s.erase(5); 
cout << s << endl; 


writes abcde to the screen. (Remember, for the original string, s [5] is f.) 
The statement s.erase (pos, nchars) ; deletes nchars of s starting at s[pos]. 
For example, 


string s = "abcdefghijklmnopqrstuvwxyz"; 
s.erase (5,3); 
cout << s << endl; 


writes abcdeijklmnopqrstuvwxyz to the screen 


A portion of a string can be modified using the replace method. The statement 
s.replace (pos,nchars,new_chars) ; deletes nchars Starting at position pos, 
and then inserts new_chars in place of the missing portion. The new_chars may 
be either a st ring or a char» character array, and may be of any length. Here is an 
example: 
string s = "abcdefghijklmnopqrstuvwxyz"; 


s.replace(5,16,"..."); 
cout << s << endl; 


This writes abcde. ..vwxyz to the screen. 
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The substr method is used to extract a substring of a string; it does not mod- 
ify the string. The expression s.substr (pos) returns the substring of s starting 
with character s[{pos] through to the end of s. More generally, the expression 
s.substr(pos,nchars) returns the substring of s starting with s [pos] up to, but 
not including, s [pos+nchars]. Here is an example. 


string s = "abcdefghijklmnopqrstuvwxyz"; 
cout << s.substr(5,3) << endl; 


This writes fgh to the screen. 


The length of a string can be ascertained using either s.size() or s.length(). 
One can test if the string is an empty string with s.empty() which returns true if 
the length of s is zero. 


Square brackets can be used to access a given character in a string (either for 
reading or for modification). In consonance with C++ principles, s [0] is the first 
character of s. This code 
string s = "good luck"; 

s(2] = '1'; 
cout << s << endl; 


writes gold luck on the screen. The value between the square brackets must be 


nonnegative and less than the length of the string. Alternatively, the at method may 
be used: s.at (k) gives character number k of the string s (i.e., s[k]). 


Two string objects may be compared using the standard C++ comparison oper- 
ations: ==, !=, <, <=, >, and >=. The ordering is mostly lexicographic. However, 
all uppercase letters precede lowercase letters. The following program illustrates the 
ordering of string values; note that sort implicitly relies on the < operator. 





Program 14.1: A program to illustrate the sorting of st ring values. 


#include <iostream> 
using namespace std; 


const int NWORDS = 7; 


int main() { 

string words [NWORDS]; 
words[0] = " zebra"; 
words[1] = "ant eater"; 
words[2] = "Aaron"; 
words[3] = "aardvark"; 
words[4] = "Baltimore"; 
words[5] = "anteater"; 
words[6] = "BREAKFAST"; 


sort (words, words+NWORDS) ; 


for (int k=0; k<NWORDS; k++) { 
cout << words[k] << endl; 


} 
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Here is the output of this program. 





zebra 
Aaron 
BREAKFAST 
Baltimore 
aardvark 
ant eater 
anteater 





In a dictionary, aardvark precedes Aaron, but C++ sorts these the other way around 
because uppercase A comes before all lowercase letters. The space character pre- 
cedes all letters, hence _.zebra is first in the sorted output. 


14.2.3 Searching 


The string class provides methods for searching for substrings. The most basic 
of these is find. The method is invoked with an expression such as s. find (pat) 
where s is a string and pat isa string ora chars. It returns the location of the 
first occurrence of pat in s. The following code prints the number 8 on the screen. 


string s = "abcdefghijklmnopqrstuvwxyz"; 
cout << s.find("ijk") << endl; 


What happens if find cannot find pat? The answer is complicated. To begin, we 
need to explain that find returns a value of type std: :string::size_type. (If 
you include the statement using namespace std; then you may drop the prefix 
std::.) In most cases, we save the value returned by find in a variable for further 
processing. To do this, we use code such as this: 


string s = "I feel like a louse"; 
string pat = "eel"; 
string::size_type idx; // or std::string::size_type idx; 


idx = s.find(pat); 


In this case, idx is set equal to 3. 

If, however, pat is set to "house", then find returns a special value named 
std::string::npos. (The prefix std:: may be omitted if we have the state- 
ment using namespace std;.) Here is a short program that illustrates how to use 
find. 


#include <iostream> 
using namespace std; 


int main() { 
string s = "Mississippi"; 
string pat; 
cout << "Enter substring --> "; 
cin >> pat; 
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string::size_type idx; // or std::string::size_type idx; 
idx = s.find(pat); 


if (idx != string::npos) { 
cout << "The substring \"" << pat 
<< "\" was found at position " << idx << endl; 
} 
else { 
cout << "The substring \"" << pat << "\" was not found" 
<< endl; 


return 0; 


} 


Here are two runs of the program. 





Enter substring --> ssi 
The substring "ssi" was found at position 2 








Enter substring --> sse 
The substring "sse" was not found 





Closely related to find is the rfind method. The statement s.rfind(pat) 
returns the index of the last occurrence of pat ins, or string: :npos if pat cannot 
be found. 


Two additional string searching methods are provided: find_first_of and 
find_last_of. The expression s.find_first_of (pat) searches the string s 
for a character that is found in pat and returns its index. If none of the characters in 
pat is present in s, then string: :npos is returned. Here is a program to illustrate 
how this works. 


#include <iostream> 
using namespace std; 


int main() { 
string s = "Mississippi"; 
string pat; 
cout << "Enter substring --> "; 
cin >> pat; 


string::size_type idx; // or std::string::size_type idx; 
idx = s.find_first_of (pat); 


if (idx != string::npos) { 
cout << "One of the characters \"" << pat 
<< "\" was found at position " << idx << endl; 
} 
else { 
cout << "None of the characters\"" << pat << "\" was found" 
<< endl; 


return 0; 
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Here are two executions of this code. 





Enter substring --> aeiouy 
One of the characters "aeiouy" was found at position 1 








Enter substring --> wxyz 
None of the characters"wxyz" was found 





The expression s.find_last_of (pat) method gives the index of the last char- 
acter in s that is also in pat, or string: :npos if no such character exists. 


14.2.4 Converting between st ring and char» types 


Conversion from a null-terminated character array (type charx) to a string 
is easy. If word is a char» (character array) and s is a string, the assignment 
s = word; does the job. Alternatively, we can convert word to a string when 
s is declared: 


string s(word); 


Finally, we can write string (word) to convert word into a string. 

The conversion from a string to a char* is more complicated. The string 
class includes a method called c_str for this purpose. The expression s.c_str() 
returns a pointer to an unmodifiable, null-terminated character array with the same 
contents as s. 
string s = "Leonhard Euler"; 


const char* word = s.c_str(); 
cout << word << endl; 


Notice that word is declared const; omitting this keyword results in an error. If you 
need to do further processing on the character array returned by c_str, you need to 
copy the characters into another char» array and work on that copy. 

Fortunately, one rarely needs to convert a string to a char. The exception 
is when we wish to use a procedure that takes a char argument, but no string 
alternative is available. (For an example, see Exercise 14.1.) 





14.3 Command line arguments 


In all the programs we have presented thus far, data are entered into the program 
using a prompt/response paradigm: 


cout << "Enter n --> "; 
cin >> nj; 


An alternative mechanism for sending a few values to a program is to use com- 
mand line arguments. For example, a greatest common divisor program, named gcd, 
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would be invoked from the terminal by typing gcd 289 51. The arguments are sent 
to main as character arrays, "289" and "51". The main procedure then needs to 
convert these to integers, send those values to a gcd procedure, and print the result. 
Here is how all of this is accomplished. 

The first step is to declare main in a different manner. Thus far in this book, main 
has been always declared as int main(). In this version, no arguments are sent 
to main and an integer value is to be returned. The alternative declaration for main 
specifies arguments: 


int main(int argc, char** argv) { ... } 


The first argument is an int value that specifies the number of arguments typed on 
the command line. The name of the program itself is considered an argument, so this 
number is always at least one. The name of this argument is not required to be argc 
(for “argument count’) but this convention is nearly universal, so you are encouraged 
to follow suit. 

The second argument, named argv, is an array of character arrays (hence the 
double star). This need not be named argv, but this name is also nearly universally 
used for this purpose. 

When main is invoked, this array is populated as follows: the character array in 
argv [0] is the name of the program. The arrays argv [1] through argv [argc-1] 
are the other arguments on the command line. An example makes this clear. 





Program 14.2: A program that illustrates how to access command line arguments in 
amain. 


#include <iostream> 
using namespace std; 


HGS WNeVer(Giigie, Zigerelp Clacuerc: eleeny)) 4 
@ie ((Atete IeaOp Vexeueties leiar)y 4 
eoue << Venacy(\ K< Ik << Wi) als VY << suse (pe) << Giavclile 
} 


return 0; 





Suppose this program is compiled and the executable is called test-main. If the 
program is run with the command line 


./test-main one two 3 negative-four 


the following output results. 





argv[0] is ./test-main 
argv[1] is one 

argv[2] is two 

argv[3] is 3 

argv[4] is negative-four 





Note that in this case, argc equals 5 accounting for the name of the program and the 
four additional arguments passed to the program. 


eCeADMN PWN 


12 
13 


Strings, Input/Output, and Visualization 299 


The command line arguments are sent to main as character arrays. Often, we want 
to convert these values to integer or double values. Unfortunately, the following does 
not work. 


int main(int argc, charx* argv) { 


int nl; 
nl = argv[1]; // INCORRECT 
cout << "nl = " << nl << endl; 


return 0; 


} 


There are two problems—one minor and one serious—with the line flagged with the 
comment INCORRECT. The minor issue is that we did not check if argc is at least 2; 
if argc is only 1, then argv [1] is nota valid element of the argv array. The serious 
error is that the statement nl = argv[1]; does not convert the character array into 
an integer. Even if argv[1] holds a valid representation of a decimal integer, say 
"g9", the statement does not convert the character array into the expected integer 
value, 89. Unfortunately, on some compilers, this might not be an error.” 

To convert a character array to the numerical value it represents, use one of the 
following procedures (these are built in to C++). 





@ atoi(word) converts the character array in word to an int value. Thus, if 
word holds "-51", then atoi (word) returns the value —51. 


® atol (word) converts the character array in word to a long integer value. 


@ atof (word) converts the character array in word to a float value. 








® atod(word) converts the character array in word to a double value. 


Here is a sample program to illustrate their use. 





Program 14.3: A program to calculate the gcd of two values specified on the com- 
mand line. 


#include <iostream> 
#include "gcd.h" 


using namespace std; 


sige: ietiin (shine: Aaee,, Cliguew: eee) 


if (arge != 3) { 
egise << “weeceg Y << ame Oi) «<< Y ul mAZW «<< einclils 
eetr <4 "to tind the ced et mi -and nz" << endl; 
aCe Unamael 


} 
long nl = atol(argv[1]); 
?This program only generates a warning on my compiler. On my computer, the output of this pro- 


gramisnl = -1073743042 because the address of argv [1], when converted to a signed integer, is 
—1073743042 
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long n2 = atol(argv[2]); 
Come K<< @ el (imil in) << Siaxelilis 


return 0; 


} 





Notice that lines 7-11 check that the appropriate number of arguments are given 
to the program; if not, the program prints an error message and a reminder of how it 
should be used. Here is a sample session using this program. 








$ ./gcd 51 289 
17 


S$ ./ged 5 
Usage: ./gcd nl n2 
to find the gcd of nl and n2 


§ ./gcd hello Gauss 
0 





$ 
J 





Notes: The dollar sign is the computer’s shell prompt (not something the user types 
and not considered a command line argument). The first invocation of the program is 
properly formatted and the result is typed on the screen. The second invocation has 
an incorrect number of command line arguments; the program detects this and prints 
the error message. In the final invocation of the program the arguments ought to be 
numbers, but instead we send nonsense (hello and Gauss). We request that these 
be converted to Long values (lines 13-14). However, atol, unable to recognize 
these character arrays as representations of numbers, returns the value 0. A more 
sophisticated program could examine the contents of argv[1] and argv[2] to see 
if they held properly formatted numbers; if not, an error message would be generated. 





14.4 Reading and writing data in files 
14.4.1 Opening files for input/output 


The input/output objects cin, cout, and cerr are designed for transferring data 
from the computer’s keyboard or to the computer’s screen.* Often, however, we want 
to read data from a file (i.e., a document) or to write the results of our computation 
into a file (for later processing, or inclusion in a report or email message). 


3On most computers it is possible to redirect these input/output streams so that data, that would normally 
be written to the screen, are sent to a file (or another program) instead. 
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Fortunately, it is not difficult to declare input and output streams. These are objects 
like cin and cout, but rather than being associated with the keyboard or the screen, 
they are associated with a file on the computer’s hard drive. 

Computer files are of two sorts: plain text (or ASCII) and binary. Plain text files 
contain only the ordinary characters (of the sort that can be held in a char variable); 
that is, lower- and uppercase Latin letters, numerals, punctuation, and blank space. 
They do not contain letters from other character sets (e.g., Chinese) or other types 
of data. Examples of plain text files are .cc and -h files for programming, TREX 
and I4TRxX files, PostScript documents, and .htm1 Web pages. Binary files, on the 
other hand, contain characters beyond the ASCII set or other types of data (including 
images, sounds, etc.). Examples of binary files include Microsoft Word documents, 
multimedia files (from . jpg photographs to . wmv video), PDF documents, and exe- 
cutable programs (built from your C++ code). 

We focus our attention solely on reading and writing plain text files. Although C++ 
is capable of dealing with binary files, it is more complicated to handle such data. 
For special situations, you may be able to find publicly available C++ procedures for 
reading and writing specific types of data (e.g., . jpg files). 


To read and write from files, include the directive #include <fstream> at the 
beginning of your program. The fstream header defines two important classes: 
ifstream for input file stream and of st ream for output file stream. 

The first step is to declare an object of type ifstream or ofstream. In both 
cases, we provide a single argument giving the name of the file to be read/written; 
the argument is a character array (type char*). The constructors look like this: 


ifstream my_in("input_file"); 
ofstream my_out ("output_file"); 


The first sets up my_in to read data from a file named input_file and the second 
writes data to a file named output_file. Before we do either of these, there are a 
few important cautionary notes. 


e The file input_file might not exist or might not be readable by your pro- 
gram (e.g., if you do not have sufficient privileges to read that file). So, before 
attempting to read data from that file, we perform the following simple test. 
if (my_in.fail()) { 

cerr << "Unable to read the file input_file" << endl; 


return 1; 


} 


Input streams contain methods named fail and good. If (and only if) the 
stream is in a good state, then good () returns true and fail () returns false. 
Thus, if the file cannot be opened, my_in.fail() retums true. 


It is important to do a test such as this or else the rest of your program may run 
into trouble. 


A program also uses the good and fail methods to detect when an input file 
has been exhausted; see Section 14.4.3. 
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e Likewise, it might not be possible for the program to write to output_file 
(the disk might be locked, another program might be using the file, or your pro- 
gram may lack sufficient privileges to write a file in the particular directory). 
To test if the output file was opened successfully, use code such as this: 
if (my_out.fail()) { 


cerr << "Unable to write to the file output_file" << endl; 
return 1; 


e For output, please be aware that opening an existing file for output com- 
pletely erases the file. There’s no second chance. The file is not moved to the 
“trash” or recoverable in any way. 


These is an alternative way to open an output file that does not overwrite the 
existing file. We may open an output file so that data written to that file are 
appended to the end of the file. If this is what is desired, use the following 
constructor. 


ofstream my_out ("output_file", ios::app); 


A file stream may be associated with a file after it is declared using the open 
method. Here is an example. 
ifstream my_in; 
ofstream my_out; 
// intervening code 
my_in.open ("input_file"); 
my_out.open("output_file"); 


Alternatively, to append data to an output file, use this statement: 


my_out.open("output_file", ios::app); 


Generally, it is not necessary to close a file—the file associated with a stream is 
automatically closed when the stream goes out of scope. However, there are times 
when we need to close a file explicitly. In that case, we use the close () method. 

One instance when we would use the explicit open and close methods is when 
the command line arguments name files that we want to process. Consider the fol- 
lowing example. 





Program 14.4: A program the processes files specified on the command line. 


#include <iostream> 
#include <fstream> 
using namespace std; 


fine, iiel er (shige aliage, Claeuew amew)) 4 
ifstream in; 


irore (ioe Keilp le<euacies Weirar) 4 
in.open(argv[k]); 


CmAADUNAPWNK CO 
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CADMAS wWN 
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ae (inigy eeNIL OC) 

cerr << "xxx Unable to process file " << argv[k] << endl; 
} 
else { 

cerr << "Working on file " << argv[k] << endl; 


// do whatever we need to do with the file named in argv[k] 
jf aiel > Neher ieee Cicer 
} 
abiats eule@rser(()) p 
abigta(e Ileyeise (6) 9 
} 


return 0; 





The main for loop is bracketed by calls to in. open and in.close (see lines 9 
and 18). Each command line argument is supposed to name a file. We try to open 
the file for input; if this is not successful (line 10) we print an error message and 
move on. Otherwise, we process the file in whatever way would be appropriate, 
presumably until we reach the end of that file.* We then close the file (line 18). 

Before we step to the next file we invoke the ifstream’s clear () method. This 
resets any error conditions triggered by the ifst ream, and there are two likely error 
conditions that would arise in this program: inability to open the file and reaching the 
end of the file. After one of these events occurs, the expression in.good() yields 
the value false (and in. fail() yields true) until we cancel the error condition 
with in.clear(). 


14.4.2 Reading and writing 


Once the stream object is declared and we have tested that the file has been suc- 
cessfully opened, we can use the usual << (for ofstream) and >> (for ifstream) 
operators for writing/reading the file. Here is an example. 





Program 14.5: A program that illustrates writing data to a file. 


#include <iostream> 
#include <fstream> 
using namespace std; 


auinte: imaystsial()) 
const char* output_file_name = "example.out"; 


ofstream my_out (output_file_name) ; 


ake (iy Owls oie IL ()) 4 
cerr << "Unable to open the file " << output_file_name 
Se FT ior wee ing 3" eens 


return 1; 


4End of file detection is explained in Subsection 14.4.3. 
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for (int k=l; k<=10; k++) { 
MUO. ee ee hs 
} 


my_out << endl; 


return 0; 





After this program is compiled and run, a file named example. out is created and 
its contents look like this: 


12345678 9 10 


14.4.3 Detecting the end of an input file 


When reading data from a file, a program might not know a priori how many data 
are in the file. For example, the file may contain many integers and it’s the program’s 
job to sum those integers. To do this, the program repeatedly requests input (using 
the >> operator) until it reaches the end of the file. 

The question is, how does a program tell when it has reached the end of an input 
file? The solution is to use the ifstream’s good and fail methods. 

When a file has been exhausted, the expression ifstream.fail() yields the 
value true. The following program illustrates how to use this idea; it sums the 
numbers it finds in the file example. out generated by Program 14.5. 





Program 14.6: A program that sums the integer values it finds in a file. 


#include <iostream> 
#include <fstream> 
using namespace std; 


int main() { 
const char*x input_file_name = "example.out"; 


ifstream my_in(input_file_name) ; 


aie (iiye_alin, teat () i) 4 
cerr << "Unable to open the file " << input_file_name 
Se." for input." x< endl; 


return 1; 
} 
abo. 1009 
int sum = 0; 
while (true) { 
ly Shia. SS inp 
nlite (Miya Tae eles ()e)elongealls 
sum += nj; 
} 


cout << "The sum of the numbers is " << sum << endl; 


return 0; 
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Focus your attention on lines 16—20. The loop is controlled by the construction 
while (true) {...}. Theloop runs forever until the break on line 18 is reached. 
When my_in.fail() is evaluated one of two things happens: either (a) the pro- 
gram has successfully read an integer into n or else (b) there are no more values left 
in the file to be found (because we have reached the end of the file). In case (a), 
my_in.fail() evaluates to false. However, in case (b), it evaluates to true. 
Therefore, the loop continues as long as the input is successful. Once the end of 
the input file is reached, the loop terminates and the sum of the values in the file is 
written to the computer screen. The output of this program looks like this: 





7 
| The sum of the numbers is 55 


Mey 





14.4.4 Other methods for input 


The >> operator handles most input needs. When handling character data, how- 
ever, it is sometimes useful to be able to deal with single characters and with full 
lines of text. 

The get method is used to read a single character from an input stream. Here’s an 
example. 


char ch; 
cin.get (ch); 
if (cin.good()) { 
cout << "We read the character " << ch << endl; 
} 
else { 
cout << "No more input available" << endl; 


} 


The statement cin. get (ch) reads a single character from the stream cin and stores 
the result in the variable ch. 

The expression cin.get (ch) is not equivalent to cin >> ch. The former reads 
the next character available no matter what, but the >> statement skips any white 
space before reading a character. Consider this program. 


#include <iostream> 
using namespace std; 


int main() { 


char ch; 

cout << "Type something -->"; 

cin >> ch; 

cout << "We read the character ’" << ch << "’" << endl; 
cin.get (ch); 

cout << "We read the character ’" << ch << "’" << endl; 


return 0; 


} 


Here are some sample executions of the code. 
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Type something -->123 














cr 











We read the character '1’ 
We read the character ’2’ 
gf 
Type something --> 123 
We read the character '1’ 
We read the character ’2’ 
) 
> 
Type something --> 1 2 383 
We read the character '1’ 
We read the character ’ ’ 
aw 





In the first execution, the cin >> ch; statement reads the character 1 and then 
the cin. get (ch); reads the character 2. The same thing happens in the second 
execution because cin >> ch; skips the white spaces before the 1. However, in 
the third run, the statement cin. get (ch) ; reads the space character immediately 
following the 1. 

There is also a put method for output streams; it is used to write a single char- 
acter. If ch is a char variable, the statement cout.put (ch); is tantamount to 
cout << ch;. 


Suppose word is a string variable. The statement cin >> word; skips white 
space before reading data into the variable word, and then stops as soon as additional 
white space is encountered. For example, the user types 


Suppose $f$ is continuous. 


then the statement cin >> word; puts Suppose into the variable word. If the 
statement is executed repeatedly, it would subsequently save the string $£$, then is, 
and then continuous. into word. 

Sometimes it is useful to read a full line of text into a st ring variable. There are 
two ways to do this. In both cases the procedure invoked is named getline. 

We may write cin. getline (buffer, nchars); where buffer is a character 
array (type char») and nchars is a positive integer. This statement reads at most 
nchars characters from cin and loads them into the character array buffer. The 
reading stops either when the end of the line is encountered or nchars have been 
read. Here is how this method might be used in a program. 


const int MAX_LINE = 10000; 
char buffer [MAX_LINE]; 


cout << "Type a line: "; 
cin.getline (buffer,MAX_LINE) ; 
cout << "You typed: " << buffer << endl; 


The drawbacks to this form of get line are (a) one needs to know a priori an upper 
bound on the number of characters in a line and (b) the characters are saved in a 
character array. 

The following alternative version of get line is more convenient. The statement 
getline (cin, theLine) ; (where theLine is a string variable) reads characters 
from cin until reaching the end of the line; the characters are saved in theLine. 
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Both forms of getline take an optional additional argument: a char value 
specifying a delimiter character. Then, instead of reading to the end of the line, 
getline reads until the delimiter character is encountered. For example, the state- 
ment getline(cin,theLine,’/’); reads characters into theLine until a / char- 
acter is encountered. 





14.5 String streams 


C++ provide a means to treat character strings in a manner akin to file streams. Ob- 
jects of the classes ist ringstream and ostringstream may be used in the same 
manner as input and output file streams, but their data come from (or go to) a string 
embedded in the object. The use of these classes requires a #include <sstream> 
directive. 

An istringst ream is initialized with a string ora char* array. For example, 


string line("angle 70.3 degrees"); 
istringstream is(line); 


We can now use is just as we would any other input stream object. The subsequent 
code 

string sl; 

1S) >> sil} 

double x; 

is >> x; 

string s2; 

is >> s2; 


places the string angle into s1, the value 70.3 into x, and the string degrees into 
s2. 

It’s important that the variable receiving data from an istringstream via the 
>> operator be of the appropriate type. No error is reported in this situation, but the 
contents of the variable are unpredictable. 


An ostringstream behaves in the same manner as an output stream, but the 
data it is sent are saved into a string, not a file. We declare an ostringstream 
variable without any arguments like this: 


ostringstream os; 
and then we send data using the usual << operator: os << k;. After we have fin- 


ished putting data into os we extract the string we built using the str() method. 
The following code illustrates these ideas. 


CAHANANDUNFPWNKFK TU AANAADUN FS WN KS 
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Program 14.7: A program to illustrate the use of string streams. 


#include <iostream> 
#include <sstream> 
using namespace std; 


int main() { 
ostringstream os; 


os << "The base-ten digits are"; 
ioe (idee, TSOP seer Iearsr)) oer KW ee igs 


os << endl; 
COWS KS OSaSiese (ye 


Semmae woncls(” 3.9 10 hello good bye"); 


istringstream is (words) ; 
double x; 

te Sop ff 329) 

ALINE 1aif 

18 SS me (7 10 

SCN Ss; 

eS eS eee hicielhe 


" 


Shes oe SU is ae 


jLoiaey Ley 
ae SS ikkep 7 perc! 
Cone << Ube << 3 eK igh = 
Kee Ue elioel Wo = UW Ke Ke << iaiorelilp 


return 0; 





Here is the output from the program. 





7 
The base-ten digits are 0 1 2 3 
x = 3.9, n = 10, s = hello, and 


a 








14.6 Formatting 


The statement cout << x; prints the value held in x on the computer’s screen. 


If x is a double variable, the output may look like one of these. 














Value Comment 
0.142857 decimal value of 1/7 
1.42857 10/7 

0.00142857 | 1/700 

-0.142857 | —-1/7 

2.5e+11 25%10" 

1 one 
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Notice that the number of decimal places displayed varies, but in each case at 
most six significant digits are given (not counting leading zeros). Also observe that 
positive numbers do not have a leading + sign, and that the decimal point is dropped 
when x holds an integer value. 

In most cases, the default behavior of cout << x; is adequate for mathematical 
purposes. However, we may wish to print more than six significant figures or print 
out a table with figures nicely arranged in columns. To accomplish these, we need to 
modify the default behavior of the output stream. 

A convenient way to do this is through the use of manipulators that we send to 
output streams using the << operator. Before we may use manipulators, we need the 
directive #include <iomanip> at the beginning of the program. 


14.6.1 Setting precision 


By default, real numbers sent to an output stream (such as cout) are printed with 
six decimal digits of precision. If we want more (or fewer) we use the setprecision 
manipulator. Its use looks like this: 


#include <iomanip> 


cout << exp(1l.) << endl; 


cout << setprecision(10); 
cout << exp(1l.) << endl; 


The output of this code looks like this: 


2.71828 
2.718281828 








14.6.2 Showing all digits 


Increasing the precision of the output stream does not necessarily result in addi- 
tional digits being printed. For example, the statement 


cout << setprecision(10) << 1.0 << endl; 


just prints 1 on the screen. The manipulator showpoint coerces the printing of the 
decimal point and the extra digits. The code 


cout << setprecision(10) << 1.0 << endl; 
cout << showpoint << 1.0 << endl; 


results in the following output. 





1 
1.000000000 





To restore the default behavior, send the noshowpoint object to the output stream. 
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14.6.3 Setting the width 


Setting the precision of the output does not directly determine the number of char- 
acters typed to the screen. A leading minus sign, the position of the first nonzero 
digit, whether the number is to appear in scientific notation, and whether showpoint 
is in effect all influence the number of characters that cout << x prints. This vari- 
ability can wreak havoc with any attempt to line up the output in neat columns. 

By default, cout << x; prints x in exactly as much space as required; no extra 
space is padded. 

The setw manipulator provides a mechanism that guarantees the number of char- 
acters cout << x; prints. The statement 


cout << setw(20) << x; 
prints the value stored in x in a field that is 20 characters wide. If cout << x would 


normally produce fewer than 20 characters, then, by default, the value is printed right 
justified in the 20-character region. The code 


cout << ’|’ << setw(20) << exp(1l.) << ’|’ << endl; 


results in this output. 





| 2.71828 | } 





It is possible for the printed value to appear left or right justified within the amount 
of space specified by setw. The manipulators controlling this are named left and 





FAGHE: 

cout << ’|’ << setw(20) << left << exp(l.) << ’|’ << endl; 
cout << ’|’ << setw(20) << right << exp(1l.) << ’|’ << endl; 
[2.71828 | 

| 2.71828 | 





Unlike the setprecision and showpoint manipulators, the effect of set w does 
not persist between outputs. Once output has been sent, the effect of set w is imme- 
diately canceled and the default behavior is restored. The code 


cout << ’|’ << setw(20) << exp(1.) << ’|’ << M_PI << ’|’ << endl; 


gives the following result. 





Gs fy 
| | 2.71828/3.14159| J 





When using setw, the extra characters typed are spaces. However, this can be 
changed with the set £il1 manipulator. Here is an example. 


string hi("Hello Gauss"); 

cout << setfill(’-’); 

cout << setw(20) << hi << endl; 

cout << setw(20) << left << hi << endl; 





SSR Sse 5F Hello Gauss 
Hello Gauss------~--- 
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14.6.4 Other manipulators 


There are several additional manipulators available in C++; here we mention some 
of them that you might find useful. 


® cout << showpos: This causes nonnegative numbers to be prepended with 
a + sign. To restore the default behavior, use noshowpos. 


@ cout << scientific: This forces real numbers (types float and double) 
to appear in scientific notation. To restore default behavior (real values are 
either printed in decimal or scientific notation depending on their value) use 
the statement cout << setiosflags(ios::floatfield) ;. 


The mantissa of the real value is separated from the power of 10 by the letter 
e. The case of the letter e can be modified using the manipulators uppercase 
and nouppercase. 


@ cout << fixed: This forces real numbers to be printed in decimal notation 
(and not scientific). For example: 
cout << exp(20.0) << endl; 


cout << fixed; 
cout << exp(20.0) << endl; 





r 
4.85165e+08 
485165195.409790 





Restore default behavior with cout<<setiosflags (ios::floatfield) ;. 


@ cout << boolalpha: By default, bool values are printed as 0 or 1. After 
applying the boolalpha manipulator, these are printed as false and true. 
Restore the default behavior with cout << noboolalpha;. 


@ cout << dec, cout << oct, and cout << hex: Integer values are nor- 
mally printed in base ten, but may also be printed in base eight (octal) or 
sixteen (hexadecimal). Use these manipulators to select the desired base. 





14.7. A class to parse files 


We close this chapter by presenting a class for parsing files. In applied work, 
mathematicians often are given files containing data. It can be an annoying chore 
simply to read the file into a program. For example, a file might contain geometric 
information about a large molecule. The input file specifies the molecule with various 
kinds of lines: 


XY 
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e Type and location of atoms: These lines have the following format: 


ATOM atom_number symbol x-coord y-coord z-coord 


e Chemical bonds: These lines have the format: 


BOND atom_number atom_number 
e Comments: These lines begin with a # and are followed by arbitrary text. 
e Blank lines. 


Such an input file might look like this: 


# Data acquired from the ACME Molecule Machine and 
# saved in directory /shared/molecules/specimen-4. 
ATOM 1C 0.0 0 

ATOM 2 H 10 0 

ATOM 3 Br 0 -1 0 

ATOM 4 C OO. a2 


#Here are the bonds 


BOND 1 2 
BOND 1 4 
BOND 1 4 
# Note double bond between the carbons 
BOND 1 3 


The LineParser class we present in this section is a device that reads a file (such 
as the molecule description file above) one line at a time, and then breaks the line 


into individual words. The class provides the following methods. 





e Theconstructor LineParser (file_name): This creates anew LineParser 


object that reads data from the file named in the char« array file_name. 


e A method read() that reads a line from the input file and breaks it into indi- 
vidual words. This method returns t rue if it is able to read a line. Let’s call 


the last line processed by read () the current line. 


e A method show_line() that returns the current line. 


e A method show_line_number () that gives the line number of the current 


line. 


e A method num_words () that reports the number of separate words found on 


the current line. 


e A square brackets operator to get the words on the line. If LP is a LineParser 


object, LP [k] returns the kth word of the current line. 


Here are the header and program files for the LineParser class followed by a 


main program that illustrates the use of this class. 
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Program 14.8: Header file for the LineParser class. 


#ifndef LINE_PARSER_H 
#define LINE_PARSER_H 
#include <fstream> 
#include <vector> 
#include <string> 
using namespace std; 


class LineParser { 


private: 
ifstream sidrare 
string theLine; 
long lineNumber; 
Int nWords; 
vector<string> words; 
void parse (); 
pouuloyll Sg 


LineParser(const charx file_name) ; 
bool read (); 


string show_line() const { return theLine; } 
long show_line_number() const { return lineNumber; } 
int num_words() const { return nWords; } 
string operator[] (int k) const { return words[k]; } 
}; 
#endif 








Program 14.9: Program file for the LineParser class. 


#include "LineParser.h" 
#include <sstream> 
#include <iostream> 
using namespace std; 


LineParser::LineParser(const char* file_name) { 
in.open(file_name) ; 
aie (ase) 
cerr << "WARNING: Unable to open " << file_name << endl; 
} 


lineNumber = 0; 
theLine = ""; 
} 
bool LineParser::read() { 
getline (in, theLine) ; 
bool result = in.good(); // check if getline succeeded 
if (result) { 
lineNumber++; 
parse(); 


I 


return result; 
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24 
25 void LineParser::parse() { 
26 words.clear(); 
27 words.resize(100); 
28 istringstream s(theLine) ; 
29 nWords = 0; 
30 Surin cmp: 
31 while (s>>tmp) { 
32 if (words.size() < unsigned(nWords)) words.resize(nWords+10) ; 
33 words [nWords] = tmp; 
34 nWords++; 
35 } 
36} 
Program 14.10: A program to demonstrate the use of the LineParser class. 
1 #include "LineParser.h" 
2 #include <iostream> 
3 using namespace std; 
4 
REictc: Welle (slit eleee, Clacies Eucenn) if 
6 
7 i darge tS 2)" 4 
8 cerr << "Usage: " << argv[0] << " filename" << endl; 
9 return 1; 
0 } 
1 
2 LineParser LP(argv[1]); 
3 
4 while (LP.read()) { 
5 @iohe Ke Wilyliney WOK APS Slovery_ isvevsy_ iotimlsyeue (0) <<< Wee \ 
6 << 2 Slovo Iara ()) << WwW << “Gysielill <eg “hayelilie 
7 for (int k=0; k<LP.num_words(); k++) { 
8 Ce es Word See ee pe NEN ee a ie) Se) PO een 
9 } 
20 Gk 8 |) OLB GN ae ai ae lca sn tS a a at a aaa aac te sha ean a Se 
21 << endl; 
22 } 
23 
24 return Uj; 
25 
When the main program is run on the following four-line file 
What’s it all about, Alfie? 
Catch 22 
Nothing on the previous line! 
we obtain the following output: 
{tine 1 "What’s it all about, Alfie?" 
Word 0 is "What’s" 
Word 1 is mart 
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Word 2 is mali? 

Word 3 is "about," 

Word 4 is "Alfie?" 

Line 2 "Catch 22 ” 
Word 0 is Tatan" 

Word 1 is "22" 

Line 3 mn 

Line 4 "Nothing on the previous line!" 
Word 0 is "Nothing" 

Word 1 is "on" 

Word 2 is “ehe® 

Word 3 is "previous" 

Word 4 is "line!" 








14.8 Visualization 


The visualization of mathematical objects often provides important insights. Com- 
puters are particularly adept at producing precise beautiful images. 


Unfortunately, drawing pictures on the computer’s screen is often closely tied to 
the computer’s operating system; such a program created for the Windows operating 
system is unlikely to work on an X-windows (UNIX) or Macintosh computer. In 
addition, it can be frustrating and time consuming to understand the intricacies of 
opening windows, drawing graphic objects, translating between mathematical coor- 
dinates and screen coordinates, printing, and so forth. 


Still, visualization is too important to dismiss and so we offer guidance on how to 
use C++ to draw pictures in a platform-independent manner. 


One strategy, which we consider only briefly, is to write a C++ program whose 
textual output is used as input to another system with built-in graphics capabilities. 
For example, the C++ program could write a file in which each line contains a pair 
of real values. This file would then be loaded into a system such as MATLAB or 
Mathematica and plotted. 


Alternatively—and this is the technique we explore—we can write a C++ program 
whose output is a well-established graphics file such as GIF, JPEG, or EPS. This file 
can then either be displayed on the computer’s screen (using an appropriate viewing 
program) or incorporated into a word-processing document (such as MS Word or 
IATxX). 
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14.8.1 Introducing and installing the plotutils package 


Let’s start with an assumption. We do not want to learn how graphics files (such as 
GIF, JPG, or EPS) work; we just want to think about drawing in mathematical terms. 
Line segments should be specified by their end points and circles by their centers and 
radii. Someone else should work out how these various graphics formats work and 
provide us with an easy way to draw. Fortunately, someone else has done exactly 
that. 

The GNU plotutils package is free software that provides device-independent 
drawing tools with output to a variety of popular graphics file formats. The package 
can be downloaded from the following Web site, 


http: //www.gnu.org/software/plotutils/ 


The package arrives as a single compressed “tar” file> in which all the plotutils 
files are held. Installation is mildly complicated. Installation instructions can be 
found in the files INSTALL and INSTALL. pkg, but these can scare the uninitiated. 
Follow this outline. 


e Unpack. It is necessary to extract the various source files for the plotutils 
files from the downloaded file. On some computers, this may be as simple 
as double-clicking the downloaded file. On a UNIX system (or in Cygwin on 
Windows), you can unpack with the following command, 


tar xfz plotutils-2.4.1.tar.gz 


(The precise file name may depend on the version you downloaded; be sure to 
fetch the latest.) 


You should now have a folder on your hard drive named plotutils-2.4.1 
(or something similar). 


e Configure. The next step is to run the configure program found in the folder 
you have just unpacked. This is done from a command line such as this: 


./configure --enable-libplotter --prefix=directory 


Here, directory is a directory where you want the package to be installed. 
This may be your home directory, a subdirectory of your home directory, or a 
public directory such as /usr/local or /usr/public. Please note that the 
installation procedure (described below) adds files to various subdirectories of 
these directories; if those subdirectories do not already exist, the install process 
creates them for you. These subdirectories are named bin, lib, include, and 
so on. 


The option --enable-libpotter enables the C++ version of plotutils. 
(Without this option, only the C version is built.) 


5The word tar is an acronym for tape archive; this file format provides a mechanism for packaging many 
files together and need not be associated with storing data on a tape. 
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e Build. The package is built using a single command: make. Even on a fast 
computer, this process takes a while. 


e Create the documentation. The plotutils package comes with a reference 
manual (and other documentation). To build this, type make dvi. This creates 
the file plotutils.pdf in the info subdirectory. This can be read (and 
printed) using Adobe Acrobat Reader or another PDF viewer. 


e Install. Thus far, all the work of configuring and building the package takes 
place in the directory (folder) where you unpacked plotutils. The final step 
is to transfer the pieces to the directory you specified in the configuration step. 
This is quick and easy; type the command make install. 


This copies header files (such as libplotter.h) to the include subdirec- 
tory of the directory you specified in the configuration process, library files to 
lib, executable programs to bin, and so on. 


If you have a Linux computer, it is possible that plotutils is already installed. 
If not, a precompiled version can be found by visiting this Web site, 


http://rpmfind.net/linux/RPM/index. html 
and searching for plotutils. The package is then installed using Linux’s rpm 


command (for which you must have superuser privileges). 


Installing plotutils is nontrivial, but not insurmountable. If possible, seek a 
friendly computer expert to assist you through this process. Rest assured that in- 
stalling plotutils is the most difficult step in using it to draw pictures. 


14.8.2 Drawing with plotutils—a first example 


We begin by creating a program (see Program 14.11) to draw the symbol ®. It is 
easy to describe this symbol mathematically. It consists of two line segments and a 
circle. To be specific, the first line segment joins the points (—1,—1) to (1, 1) and the 
second line segment joins (—1,1) with (1,—1). The circle is centered at the origin 
with radius 2. Once we set up plotut ils, drawing the picture is just that easy. 

In broad strokes, the steps to produce the image are these. 


e Select the appropriate subclass of Plotter, 
e Declare the Plotter object with the appropriate arguments, 


e “Open” the Plotter and perform other initialization including establishing a 
coordinate system and pen attributes, 


e Draw the image, and 
e Close the Plotter. 


Finally, we need to compile and run the program. 
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Choosing the appropriate plotter type 


The plotutils package is capable of producing various types of graphics files 
including gif, eps, and several others. Fortunately, the methods for creating images 
for these various formats are all identical. If we write code to produce one type of 
file and subsequently decide we prefer another type, it is easy to change the code to 
implement the new choice. 

Each drawing is produced by an object that is a subclass of the type Plotter. 
To create a gif image, we declare an object of type GIFPlotter; for an eps 
image, we declare a PSPlotter object. For other graphics formats, see the file 
plotutils.pdf included in the info subdirectory. 

At this point you may be wondering, which type of file should I choose? Here’s 
some guidance. Graphic image files can be divided into two broad categories: bit 
images and vector graphics. Bit image files are (essentially) a matrix of pixels; they 
are useful for representing photographs and are manipulated using “paint” style pro- 
grams. On the other hand, vector graphic files represent their drawings using mathe- 
matical primitives such as line segments, ellipses, Bezier curves, and so forth. They 
are edited using “draw” style programs. For our first project, drawing ®, we use 
PSPlotter to produce an eps file. If were interested in drawing a picture of a Julia 
set (by plotting individual points), then we would use a GIFPlotter. 

These various constructors are defined in the header file plotter.h, so the direc- 
tive #include "plotter.h" is needed. 


Arguments to the constructor 


Regardless of which subtype of the class Plotter we choose, the declaration of 
the Plotter object is the same. The constructor requires four arguments like this: 


PlotterType(input, output, error, parameters) where 


e® input is an object of type ifstream such as cin. At present, this input 
stream is not used, so the simplest choice is to set this equal to cin. 


® output is an object of type ofstream such as cout. When the Plotter 
object writes its results, it sends it to this argument. Therefore, it is usually not 
a good idea to set this equal to cout. Rather, it is better to create a separate 
object of type ofst ream to write to a file on disk. Thus, we need the directive 
#include <fstream> and to declare an output object like this: 


ofstream pout ("filename") ; 


and use pout for the second argument to the constructor. 


e error is also an object of type fst ream to which error messages are written. 
If something goes awry during the drawing process, the Plotter object re- 
ports the problem through this output stream. The simplest choice is to set this 
to cerr, the standard error output stream. 
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® params is an object of type PlotterParams. The plotutils documen- 
tation explains various options that can be embedded in this object and then 
passed to the Plotter. However, the simplest thing to do is to specify no 
special options. Just declare an object of type PlotParams and pass that as 
the fourth argument to the constructor. 


Thus, a Plotter object is created with code that looks like this: 


ofstream pout ("picture.eps"); 
PlotterParams params; 
PSPlotter P(cin, pout, cerr, params); 


With this in place, the plotter object P is created. See Program 14.11 lines 11-13. 


Other initialization 


After a Plotter object is constructed, there are a few additional steps to take 
before we can begin drawing. The first of these is mandatory: the Plotter needs 
to be “opened.” This is analogous to opening a file for writing. To open a Plotter 
we use its openp1() method. This method returns a negative value if anything goes 
amiss. See lines 16-19 of Program 14.11. 

The next step is to establish a coordinate system. This is done by specifying the 
coordinates of the lower left and upper right corners of a square® in the pee in 


which you wish to draw. For our project, the region extending from (-3, —}5) to 


( 3, 3) is sufficient because it encompasses both line segments and the circle centered 
at the origin of radius /2. 

The coordinate system is established with the space or fspace methods. Both 
of these take four arguments corresponding to the x and y coordinates of the lower 
left corner followed by the coordinates of the upper right corner. The only difference 
between these two methods is that space takes integer arguments whereas fspace 
takes real (the f£ is for float) arguments. Thus, on line 22 of Program 14.11 we 
have 


P.tspace'(-1.5,.-1.5, I.5, 1.5) 3 


but we could have used 
P.space(-2, -2, 2, 2); 


instead. 

We are nearly ready to draw; all we need to do now is select our pen (this hap- 
pens on lines 25 and 26 of Program 14.11). First we select the line width of the pen 
with the f£linewidth method. The argument produces a line thickness relative to 
the overall size of your drawing area (established with the space/fspace method). 
The color is chosen with either the pencolorname or pencolor method. The 
pencolorname method takes a char» string argument giving the English name’ 


®It is possible to specify a nonsquare rectangular region, but this results in a distorted image. The drawing 
region you specified is mapped to a square “viewport”. If your region is not square, then it is rescaled 
horizontally or vertically to make it square. This causes circles to become ellipses, and so on. 

7Of course, not all color names are recognized by this method, but the basic ones are. 
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of the color you want whereas the pencolor takes three int arguments that spec- 
ify the red, blue, and green components of the color. These arguments run from 
0 to 65,535 (2!© — 1). Invoking P.pencolor(0,0,0) loads the pen with black 
ink and P.pencolor (Oxffff, Oxffff,Oxffff) gives white (this is an instance 
where base 16 is more convenient than decimal). 

There are other pen attributes we could set to produce dotted lines. The docu- 
mentation included with plotutils explains these. Later (Program 14.14) we use 
filltype and fi11lcolorname to draw circles with an opaque interior; the circle 
we draw in Program 14.11 has a transparent interior so we do not deal with this issue 
here. 


Draw the picture and finalize 


The ® picture is drawn with three simple statements. The two line segments 
(lines 29-30) are drawn with the 1ine method: 


P.line(-1,-1,1,1); 
P.line(-1,1,1,-1); 


(There is an analogous £1ine method that takes real-valued arguments.) 
The circle is drawn with the fcircle method (line 33): 


P.fircle(0.,0.,sqrt(2.)); 


(There is an analogous circle method that takes integer-valued arguments.) 

There are many other drawing methods in the plotutils package for creating 
rectangles, ellipses, circular and elliptical arcs, and Bezier curves. These can be 
combined into compound paths (e.g., polygons) which, if closed, can contain a fill 
color. One can also write text (in a variety of fonts) and plot individual points (or 
place marker symbols at specified coordinates). See the plotut ils documentation 
for more information. 


After all drawing is complete, we close the Plotter with the closep1() method 
(see line 36). This method returns a negative value if anything goes awry with this 
step. 


Compiling and running the program 


The plotutils package contains two important pieces: a header file plotter.h 
and a library file Libplotter.a (or something similar). 

We know that a #include "plotter.h" directive is needed but if the file is not 
in a standard location, then we need to tell the compiler where to find this file. We 
also need to tell the compiler to use the plotter library and (if necessary) where 
this file is located. 

Suppose the program is named xo.cc. If plotter.h and the plotter library 
are in standard locations, the compiler command is as simple as this: 


g++ xo.cc -lplotter 
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However, if the compiler cannot find these files, it will complain. For the g++ com- 
piler (and many others), these are specified using the -1 (for headers) and -L (for 
libraries) options. For example, suppose these files are located on your computer as 
follows. 





Header file | /home/zelda/include/plotter.h 
Library file | /home/zelda/lib/libplotter.a 

















To compile, use the following command. 


gt+ xo.cc -I/home/zelda/include -L/home/zelda/lib -lplotter 


(See Appendix A.1.4 for more detail about the -1, -L, and -1 options.) 

When you run the program (named a. out or something similar) it produces the 
file xo.eps. You can now use this file in a IAIEX document or for whatever purpose 
you wish. The output of the program is shown in Figure 14.2. 

The full code for the program xo. cc follows. 





Program 14.11: A program to draw the symbol ®. 


#include <iostream> 
#include <fstream> 

#include "plotter.h" 
using namespace std; 


const charx IMAGE FILE = "xo.eps"; 
BGO WUNEVIer (kine) Zligerelp Claeuesc> eleteny)) 4 


// Construct the plotter 

ofstream pout (IMAGE_FILE) ; 
PlotterParams params; 

PSPlotter P(cin, pout, cerr, params); 


// Open the plotter 

ahi (JP sojeeisyell() << ©) 4 
cerr << "Unable to open plotter" << endl; 
ieSiebuae, Ihe 


} 


// Set up my coordinate system 
2 esioeicel(—lsa; Sls sg ies, tes) 


// Set drawing parameters 
P.flinewidth (0.05); 
P.pencolorname ("black"); 


// Draw the X 
iy Lave (=i, ih, ile il), 
ih, aleve (Sil p il, pail) p 


// Draw the circle 
Pte lieelS (Os, Os, Bemie (A) 6 


// Close the image 


36 
37 
38 
39 
40 
41 
42 


nk WN 
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if (P.closepl() < 0) { 
cerr << "Unable to close plotter" << endl; 
return 1; 


} 


return 0; 








Figure 14.2: The symbol ® drawn by Program 14.11. 





Although we can use C++ to draw pictures such as ®, mouse-driven drawing 
programs are more convenient for producing such simple diagrams. The advantage 
in using C++ to draw accrues when we want to visualize a mathematical object that 
requires nontrivial computation to produce. 

We demonstrate this now with three examples. 


14.8.3 Pascal’s triangle modulo two 


Pascal’s triangle is a table of the binomial coefficients; the nth row (beginning with 
n = 0) contains the values (5), (),.--» ("). There are myriad interesting properties 
of binomial coefficients and Pascal’s triangle. One of the more striking is to look at 
Pascal’s triangle with entries taken modulo 2. That is, we plot a black point for each 
odd entry of Pascal’s triangle (and leave even entries blank). 

Because the image is an array of dots (pixels), we use a GIFPlotter object to 
do the drawing. Although we could create an array to hold all the entries in Pascal’s 
triangle, we opt instead to create two arrays to hold individual rows (the current row 
built from the previous row). 


Here is the code which should be self explanatory. 





Program 14.12: A program to visualize Pascal’s triangle modulo 2. 


#include <iostream> 
#include <fstream> 

#include "plotter.h" 
using namespace std; 





39 





K 
COoOmAANADNPWNK OS 


mn 
ee 


Strings, Input/Output, and Visualization 


const charx IMAGE_FILE = "pascal.gif"; 
const ine 


int main() { 


NROWS = 2048; 
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// Place to hold row of Pascal’s triangle and a copy to generate the 
// next row. 

int row[NROWS+1]; 

int prev_row[NROWS+1]; 


iE) 


r (int i=0; i<=NROWS; i++) { 
row[i] = 0; 
prev_row[i] = 0; 


// Construct the plotter 
PlotterParams params; 
ofstream pout (IMAGE_FILE) ; 
GIFPlotter P(cin, pout, cerr, params); 


// Open the plotter 


aE 


(P.open 
cerr << 
return 1 


ol) < 0) i 


"Unable to open plotter" << endl; 


, 


// Set up my coordinate system 
P.space (-1,-1,NROWS+1,NROWS+1); 


// Set drawing parameters 
P.pencolor 


// Generate rows of Pascal’s triangle 


iO) 


ie (Guahe se 
row[0] = 
ioe (alotie 

row[j] 





Hy wilere 
Oe (aiwie 
if (ro 
12) fox) 





// copy 
e@ie (ate 


name ("black"); 


=0; r<NROWS; r++) { 


, 
jalp JSeg Ser) a 


points for this row 
=08 WSS"e ahs) 1 
wii] == 2) wf 

int (NROWS-r, 4); 





row to prev_row 


3=0; j<=r; j++) prev_row[j] = row[j] 


// Close the image 


ae 


(BP. clos 
cerr << 
return 1 


gol) < Oy 4 
"Unable to close plotter" 


, 


= (prev_row[j-1]+prev_row[j]) 32; 


<< endl; 


(mod 2) 
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62 return 0; 
63 } 





The output of this program (Figure 14.3) is the beautiful fractal known as Sierpin- 
ski’s triangle. 








Figure 14.3: Visualizing Pascal’s triangle modulo 2. 





14.8.4 Tracing the motion of a point moving randomly in a triangle 


The next example visualizes the following process. Three fixed points (named A, 
B, and C) are located at the vertices of an equilateral triangle. A moving point X 
begins at one of these locations and then moves to a new location at random. At each 
step, the new location is the midpoint of one of the segments AX, BX, CX—each 
with probability ; Imagine that each time we find a new location for X, we plot a 
point in the plane. After many iterations, what do we see? 


Program 14.13 draws a picture by precisely this mechanism. Because the image is 
a collection of pixels, it makes sense to use a GIFPlotter to produce a gif image 
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file. 

The code is reasonably straightforward. One feature we want to emphasize is 
the procedure draw_point on lines 11-13. This procedure takes two arguments: a 
Plotter and a Point (see Chapter 6). This procedure is invoked inside main on 
line 78 where it is passed a GIFPlotter named P (and a Point named x). At first 
glance this may appear to be a programming error: the procedure requires a Plotter 
but is invoked with a GIFPlotter. This mismatch of types is not a problem because 
a GIFPlotter is a subclass of Plotter. 





Program 14.13: A program to plot points in a triangle by a random method. 


#include <iostream> 
#include <fstream> 
#include "plotter.h" 
#include "Point.h" 
#include "uniform.h" 
using namespace std; 


const charx IMAGE_FILE = "dance.gif"; 


// Draw a point on a plotter. 
void draw_point (Plotteré P, const Point& X) { 
P.fpoint (X.getX(), X.getY()); 


aLigle, Weta (Gheie) Elitee, Claeues Euaen) if 
// check that user specified number of points 
aie (Aege < 2) 4 
cerr << "“Usager “<< arov(0)]) <<" points” << endl; 
Sie wliain IL 


int NPOINTS; 
// convert 2nd arg to an integer; make sure its positive 


NPOINTS = atoi(argv[1]); 
ie (NPOUNES < i} f 





corp can aeage. “<a caren) <<“ enpoinge™ -<< Lendl ¢ 
cerr << "where npoints is a positive integer" << endl; 
mercwiem bp 


// Set the corners of the triangle 
Doane A(Os. Oc )s 

wonton ies. 05); 

POI OO. e Sores Vy Sais 


Point X; // the dancing point 


// Construct the plotter 
PlotterParams params; 

ofstream pout (IMAGE_FILE) ; 

GIFPlotter P(cin, pout, cerr, params); 
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// Open the plotter 

ae (Pope () «< ©) 4 
cerr << "Unable to open plotter" << endl; 
return 1; 


// Set up my coordinate system 
2 eso (Oa, On pdlap das 


// Set drawing parameters 
P.pencolorname ("black") ; 


// Draw the corners 
draw_point (P,A); 
draw_point (P,B); 
draw_point(P,C); 


// Start X at A 
X = A; 


for (int k=0; k<NPOINTS; k++) { 
switch(unif(3)) { 
case 1: 
X = midpoint (A,X); 
break; 
case 2: 
X = midpoint (B,X); 
break; 
case 3: 
X = midpoint (C,X); 
break; 
default: 
oerr << "This can’t happen” << endl; 
} 
draw_point (P,X); 
} 


// Close the image 

aie (IP .Cikosieyail () < Oy 1 
cerr << "Unable to close plotter" << endl; 
return 1; 


return 0; 





When the program is run we again see Sierpinski’s triangle! See Figure 14.4. 


14.8.5 Drawing Paley graphs 


Our final drawing example is a program to draw Paley graphs. In this context, a 
graph is a pair (V,E) where V is a finite set of vertices and E is a set of unordered 
pairs of distinct vertices; elements of E are called edges. The edge {u,v} is said to 
join its end points, u and v; we call such vertices adjacent. Note that is adjacent 
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Figure 14.4: An image based on a random process in a triangle. 





to is a symmetric relation because the pairs in E are unordered. Furthermore, self- 
loops are not allowed (edges that join a vertex to itself). Such graphs are often called 
simple graphs. 

It is useful to visualize graphs by drawings. The vertices are drawn as dots and 
edges as line segments (or curves) joining their end point’s dots. In our program, we 
draw the vertices as small circles. 

The Paley graphs form an interesting class of graphs. Let n > 3 be an integer. 
The vertices of G, are the integers {0,1,2,...,n}. Two vertices, u and v, of G, 
are adjacent (joined by an edge) if and only if uv —v is a perfect square (quadratic 
residue) in Z,. Because the is adjacent to relation is symmetric, we require that —1 
be a perfect square in Z,; otherwise G,, is undefined. 

For example, let n = 5. The vertices of Gs are {0,1,2,3,4}. The (nonzero) 
quadratic residues in Zs are 1 and 4. Therefore, the edges of Gs are {0,1}, {1,2}, 
{2,3}, {3,4}, and {0,5}. In other words, Gs is a 5-cycle. However, G7 is undefined 
because —1 = 6 is not a perfect square in Z7. 

Our program to draw Paley graphs reads the parameter n from the command line 
(see lines 11-25 of Program 14.14) and then stores all squares in Z, in a set ob- 
ject named squares (lines 31-35). After checking that —1 is a quadratic residue 
(lines 40-43), we create a table of x and y values for the vertex locations. We evenly 
place the vertices on a circle of radius n centered at the origin. 

Next we declare and initialize a PSPlotter object (lines 57-71) that sends its 
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output to a file named paley.eps (lines 8, 58, and 59). We choose a vector graphic 
format (eps) because our drawing consists of mathematically defined curves and not 
a field of points. We are ready to begin drawing. 

We first draw the edges (lines 74-83) as line segments. Then we modify the pen so 
that enclosed regions (such as circles) are filled with white ink. This is accomplished 
in two steps: a call to the £illcolorname method (line 86) to set the fill color to 
white and then P.filltype (1); (line 87) to activate region filling. The vertices 
are now drawn as circles of radius 5 (lines 88-90). 

Note that if we had not activated region filling, then the circles would have been 
transparent and we would see the full lengths of the line segments meeting at the cen- 
ters of the circles; it is more esthetically pleasing to cover that region. Furthermore, 
it is important that we draw the edges before the vertices. If we were to reverse the 
order, then the edges would be drawn on top of the circles, and we would see the 
portion of the line segment that ought to be hidden. 

The rest of the program releases the memory allocated for the arrays holding the 
coordinates of the vertices and closes the PSPlotter (line 93 to the end). 

Here is the program. 





Program 14.14: A program to draw Paley graphs. 


#include <iostream> 
#include <fstream> 
#include <set> 
#include "plotter.h" 
#include "Mod.h" 
using namespace std; 


const charx IMAGE_FILE = "paley.eps"; 


aioe Welen((liohe, elidee,. GClaeuers euceny)) 1 
// check that user specified number of points 
ae (eee < 2) 4 
CGice <x Wuiseee VY << aio Ol) << WY in! << ehorohils 
return 1; 


} 
int n; // number of vertices in the graph and the modulus 


// convert 2nd arg to an integer; make sure it’s positive 


n = atoi(argv[1]); 
aie “(ik << Sy 
emcee << WMuieaces Y K< amen (Ol) << Y ia! «<< eparelils 


cerr << "where n is an integer greater than 2" << endl; 
return 1; 


} 


// We'll only be working in Z_n 
Mod::set_default_modulus(n) ; 


// Find all perfect squares in Z_n 
set<Mod> squares; 
for(int k=0; k<n; k++) { 
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Mod S(kxk); 
squares.insert (S)j; 
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// Check if -1 is a perfect square 


Mod 


ae 


CINE << 


megiacas)r, 


(squares.find(neg1) 


return 1; 


// Create tables of the x and y coordinates of the vertex centers 


== squares.end()) { 


floatx x = new float[n]; 
float* y = new float[n]; 


double theta 


EOE 
me 
Yi, 


(int i=0; 


= 2«xM_PI/n; 


Ble <<Taye 


i++) 


{ 


[i] =n * sin(ixtheta); 
[i] =n * cos(ixtheta) ; 


Jf COMBMETWSGE ‘Elev jOlhorteere 
PlotterParams params; 
ofstream pout (IMAGE_FILE) ; 
cerr, params); 


PSPlotter P(cin, 


pout, 


// Open the plotter 


ee 


(P.openpl () 
cerr << 


ieee ile 


} 


SO) 4 
"Unable to open plotter" << endl; 


// Set drawing parameters 
P.flinewidth (0.05); 
P.pencolorname ("black") ; 


// Set up my coordinate system 
P.space(-n-1, 


=in= 1h, 


// Draw the edges 


iL@ue 


for 


(ates OF 


(int j= 


1<a= 


air il 


iar ky, 


ig alarae)) 


j<n; 


j++) 


imardl)) 9 


{ 


// if i-j is a perfect square 
Mod diff(i-j); 
if (squares.find(diff) 


Hl 


!'= squares.end() ) 


then we draw the edge 
iP tela (S< (fat) pv abl pe Dewi) 


// Draw the vertices 
P.fillcolorname ("white"); 
P.filltype(1); 


iE @Ne 


(int i=0; 


stare 


Daas | 


{ 


Nik aks) mois, Gl jerSoecie siebeucS alin Wl" << in << Siorcllp 


{ 
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@ TeLWMelsa Geli), visti, OS) ¢ 
} 


// Release allocated arrays for x and y 
delete[] x; 
delete[] y; 


// Close the image 

ime (2 .ellosejall ()) «< ©) 1 
cerr << "Unable to close plotter" << endl; 
return 1; 


} 


return 0; 





When the program is run with n = 17, the picture in Figure 14.5 is produced. 
The Paley graph G7 is interesting because it does not contain four vertices that are 
pairwise adjacent (a clique of size 4) and it does not contain four vertices that are 
pairwise nonadjacent (an independent set of size 4). All graphs on 18 vertices (or 
more) must contain either a clique or an independent set of size 4. 














Figure 14.5: The Paley graph on 17 vertices. 








14.9 Exercises 


14.1 Suppose a string variable contains the decimal representation of an integer. 
For example, string s = "7152";. Explain how to convert the string to 
an int. 


14.2 


14.3 


14.4 


14.5 


14.6 
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A string variable named file_name contains the name of a file. We want 
to read data from that file using an ifstream object named fin. Show how 
fin should be declared. 


A programmer wants to write the 26 lowercase letters a to z on the computer’s 
screen. The following code does not work. 
for (int k=0; k<26; k++) { 


cout << ’a’ + k; 


} 


What is wrong and how can this code be repaired? 


A free group is the set of all formal products one can create using a set of 
generators {a,b,c,...} and their inverses. If a generator and its inverse are 
adjacent in the product, then they can be removed. The empty product serves 
as the identity element. For example, 


(abc~'b) - (b~'cba) 


simplifies to abba or aba. 


Create a class named Free that represents elements in a free group. Use a 
string variable to hold the group element using lowercase letters for the 
generators and the corresponding uppercase letters for their inverses (i.e., A 
for a~!). 


Include an operator~ for the group product and an inverse() method. 
Also provide a << operator for printing Free objects to the screen. 


There are several procedures declared in the cct ype header that you can use 
for this exercise. These can be used to examine and modify the cases of single 
letter characters. See Appendix C.6.3 (starting on page 411) for a description 
of isupper, toupper, and so on. Read the introductory material carefully as 
toupper does not behave precisely as you might expect. 


Write a program that reads a text file and reports the frequency of each of the 
26 letters. Run the program on various texts and see if you can distinguish 
languages. 


You can find books in plain text format at http: //www.gutenberg.org. 


Polygrams. In Exercise 14.5 we analyzed writing by looking at the frequency 
of single letters. In this exercise we consider a more sensitive analysis. For a 
positive integer n, an n-gram is a sequence of n letters. For example, the word 
banana contains the 2-grams ba, an, and na. 


Create a program to count the n-grams found in a text and report the ten most 
frequent n-grams found for each of n = 2, 3, and 4. 
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14.7 Koch curve. The Koch curve is a fractal formed by the following iterative 


process. Begin with a horizontal line segment, say from (0,0) to (1,0). Draw 
an equilateral triangle using the middle third of this segment as one side, and 
then erase the side that was part of the original segment. The new path consists 
of four segments: 


(0,0) (3.0) (G2) (5.0) (1,0) 


Now repeat this basic step again on each of the four segments to create a 
polygonal path with 16 segments. The first two steps of this process are shown 


in the figure. 


The Koch curve is the result of carrying out this process ad infinitum. 





Write a program to draw (an approximate version of) the Koch curve to a user- 
specified number of iterations of the basic step. 


14.8 Mandelbrot set. Let c € C and define f(z) = 2? +c. Consider the sequence of 


iterates 
zo = 0, Ze41 = fe(Zx). 


For some values of c this sequence tends to infinity, |z;,| — co as k — o, but for 
other values of c this sequence stays bounded. 


The Mandelbrot set M is the set of all complex c such that the iterates of 
fc (starting at 0) stay bounded. Create a program to draw a picture of the 
Mandelbrot set. 


One can show that if for some k we have |z;,| > 2, then the iterates z, tend 
to infinity. So, to test if c € M, one can compute (say) the first 500 iterates 
zz testing if any have magnitude greater than 2. If so, we know that c ¢ M. 
However, if for all k < 500 we have |zsoo| < 2, one might guess that c € M. This 
guess might be incorrect, but this approach yields a reasonable approximation. 


Furthermore, based on this criterion, any complex number c with |c| > 2 can- 
not be an element of M, so one need not check a complex number a+ bi with 
\a| > 2 or |b| > 2. 


Chapter 15 


Odds and Ends 





It is not the purpose of this book to give an exhaustive coverage of every feature of 
C++. We have, by design, omitted those parts of the language that (in our judgment) 
are not useful for mathematical work. In this final chapter we present an assortment 
of additional topics that may also be of interest and utility in your work. 





15.1 The switch statement 


C++ provides a variety of control structures such as if, for, while, and do. Here 
we discuss an additional control structure: the switch statement. 

The switch statement is used to control execution depending on the value held in 
an integer variable. Suppose that x holds an integer value. If x equals 1, we perform 
operation I, if it equals 2 we perform operation II, if it equals 3 or 4 we perform 
operation III, and if it holds any other value, we do operation IV. Here is how we 
would structure this situation using if statements. 


if (x == 1) { 
// Do operation I 
} 
else { 
if (x == 2) { 
// Do operation II 
} 
else { 
if ((x == 3) I] (x == 4)) { 
// Do operation III 
} 


else { 
// Do operation IV 


} 


} 


As you can see, this is difficult to read (and awkward to type). With switch, the 
code is much clearer: 


switch(x) { 
case 1: 
// Do operation I 
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break; 
case 2: 
// Do operation II 
break; 
case 3: 
case 4: 
// Do operation III 
break; 
default: 
// Do operation IV 
} 


The outer structure of the statementis switch(x) {...} where x isan integer type. 
Within the curly braces is a sequence of case statements. Each case is followed by 
a specific integer value. When a switch statement is executed, the computer looks 
for a case that matches the value in x. If it finds one, it executes whatever code it 
finds following the case statement until it finds a break; statement. If no case 
statement matches the value of x, the computer looks for a default statement and 
executes the code that follows. (If there is no default statement, then execution 
skips to the statements following the closing curly brace of the switch.) 

Notice that two case statements can precede a section of code (for the values 3 
and 4). 

C++ does not require a break; statement between two sections of a switch 
statement. For example, if we were to delete the break; at the end of case 2, 
then (when x equals 2), first operation II would execute and then operation III would 
execute. This is known as falling through cases. In general, it is much better to 
balance every case with a matching break unless (as in the example) two cases 
execute the exact same code. The default case (because it appears at the end of the 
switch) does not require a break. 

There is no way to specify a range of values in a case statement. So, for example, 
if you want different behaviors depending on whether x is negative, zero, or positive, 
you should use if statements. 

The switch statement is useful for creating a menu of options for the user. A 
prompt is typed on the screen listing various options; the user specifies the desired 
option by typing a number or letter. The following program illustrates how this is 
done; in it, the switch statement plays a central role. The user specifies the desired 
option by typing a letter. We allow uppercase and lowercase letters and so two case 
statements are given for each option. 





Program 15.1: A program to illustrate the switch statement. 


#include <iostream> 
#include <string> 
using namespace std; 
int main() { 


bool again = true; 
while(again) { 
cout << endl; 
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Wk WW WWW WwWwWNN NN NN NN WN WY 
CANDMAFPWNK TCTUOAAADUNFPWNHE CS 





K 
COCmAANDUNPWNK OS 


mann 
wWNrF Oo 


wn 
way 


Odds and Ends 335 
cout << "What would you like to do?" << endl; 
Cowie << (a) Prove Fermat’s little theorem" << endl; 
Cour K< ? (b) Prove Fermat’s last theorem" << endl; 
Cour «< (c) List some Fermat primes" << endl; 
Cour <a0% (d) End this program" << endl; 
cout << "Type the character and hit return: "; 


string response; 
cin >> response; 


if (response.empty()) continue; 


char option = response[0]; 


switch(option) { 


Cascm cave: 
case ‘A’; 
cout << endl 
<< "Apply Lagrange’s theorem to the group Zp." << endl; 
break; 
Case abige: 
Case ar a: 
cout << endl 
<< "I have a great proof for this but, alas, it will" 
<< endl << "not fit on this computer screen." << endl; 
break; 
Casemices: 
Cals Cana Gies: 
cout << endl << "Here are the only ones I know:" << endl 
NS IS Se a ed al er Beeey MORI g 
break; 
Cais Cup aclias) 
Cais Cana Dias) 
cout << endl << "Goodbye." << endl; 
again = false; 
break; 
default: 
cout << endl << "Sorry. Your response was not recognized." 
as endl << "Please pry again.” << endl» 


} 


return 0; 





Here is a sample run of the program. 





What would you like to do? 


(a) Prove Fermat’s little theorem 
(b) Prove Fermat’s last theorem 
(c) List some Fermat primes 

(d) End this program 


Type the character and hit return: a 
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Apply Lagrange’s theorem to the group Z_p. 


What would you like to do? 
(a) Prove Fermat’s little theorem 


) 
(b) Prove Fermat’s last theorem 
(c) List some Fermat primes 
(d) End this program 
Type the character and hit return: b 


I have a great proof for this but, alas, it will 
not fit on this computer screen. 


What would you like to do? 
(a) Prove Fermat’s little theorem 


) 
(b) Prove Fermat’s last theorem 
(c) List some Fermat primes 
(d) End this program 


Type the character and hit return: C 


Here are the only ones I know: 
St VE 257 259316 


What would you like to do? 
(a) Prove Fermat’s little theorem 


) 
(b) Prove Fermat’s last theorem 
(c) List some Fermat primes 
(d) End this program 


Type the character and hit return: x 


Sorry. Your response was not recognized. 
Please try again. 


What would you like to do? 
(a) Prove Fermat’s little theorem 


) 
(b) Prove Fermat’s last theorem 
(c) List some Fermat primes 
(d) End this program 


Type the character and hit return: D 





Goodbye. 








15.2 Labels and the goto statement 


In addition to switch and all the various other control structures, C++ also pro- 
vides the simple goto statement. For good reasons, use of the goto statement is 
highly discouraged. It can lead to programs that are impossibly difficult to under- 
stand. There is, however, one situation where a goto is handy: breaking out of 
nested loops. Here is how goto works. 
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Any statement in C++ may be prefixed by a label. A statement is labeled by a 
name; a label name is formed according to the same rules as variables are named. To 
label a statement, use the label name followed by a colon, like this: 


increment: x += 10; 


This names the statement x += 10; as increment. Now, anywhere in the same 
procedure as this labeled statement, we may have the statement goto increment;. 
Whenever the goto statement is invoked, the program immediately jumps to the 
statement labeled increment and proceeds from there. 

If possible, use one of C++’s other control structures rather than resorting to the 
use of goto. However, if you need to break from a nested loop, a goto is a clean 
solution. Here’s the issue: if you want to exit a for loop before the end condition 
has been reached, you can execute a break statement. For example, 
int k; 
for (k=0; k<100; k++) { 

if (x[k] < 0) break; 


// otherwise do something 


} 


This loop stops running if any element of the array x is negative. The break state- 
ment forces the for loop in which it is contained to stop looping. Therefore, if the 
break is enclosed in, say, a double for loop, only the inner loop is interrupted. How 
can we stop the execution of the outer loop? Unfortunately, break won’t help us. 

A solution is to label the first statement after the double for loop and use a goto. 
Here is an example. 


#include <iostream> 
using namespace std; 


int main() { 
int i,j; 


for (i=0; i<10; i++) { 
for (j=0; 4<10; jtt) { 
if (it+tj == 15) goto alpha; 
} 
} 


alpha: 
cout << "i =" << i << "and j =" << j << endl; 
return 0; 


} 


The two for loops execute until i+ 3 reaches the value 15. At that point, the loops 
are interrupted and execution proceeds at the statement labeled alpha. The output 
is as follows. 





i= 6andj=9 ] 





In practice, this situation rarely occurs. You are unlikely to ever need a goto 
statement in your programs. 
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15.3. Exception handling 


In the course of a computation unexpected situations can arise. For example, the 
computer might attempt to find the inverse of a noninvertible object. If the computer 
is asked to divide by zero, it signals the invalid result in one of two ways: the di- 
vision 1./0. results in the special value inf (which stands for o°) and the division 
0./0. results in the special value nan (which stands for not a number). Similarly, 
in Chapter 9 we designed the Mod class so that if the inverse method is invoked on 
a noninvertible Mod object, the return value is an invalid Mod. 

To check that a Mod computation took place without error, the is_invalid method 
can be applied to the results. To check if a floating point calculation resulted in inf 
or nan, use the C++ procedures isinf() or isnan () a 

In some cases, it is difficult to communicate an abnormal event through a return 
value. In this case, C++’s exception system is useful. 

Although you might elect not to use the exception system, it is worth knowing its 
basics because packages that you download from the Web might use this feature. 


15.3.1 The basics of try, throw, and catch 


C++ provides an alternative method for detecting and handling such situations. 
When a procedure detects an erroneous situation, it can throw an exception. When 
the exception is thrown, the normal flow of the program is interrupted and control is 
passed to code that catches the exception. The code that might throw an exception is 
contained inside a try block. The exception-handling mechanism involves the three 
keywords try, throw, and catch and is structured like this: 


// start of the procedure 
try { 
// some calculations 
if (something_bad_happens) throw object; 
// more calculations 
} 
catch (object_type var) { 
// deal with bad situation 
} 


// vest of the procedure 


To illustrate how this works, we present the following short program that asks the 
user for two numbers and returns their quotient. 


‘Tn order to use these procedures, you need the directive #include <cmath> at the beginning of your 
program. Also, at the time of this writing, there is a bug in the Mac OS X version of C++ of cmath. 
Examine the file /usr/include/gcc/darwin/default/c++/cmath. Comment out the lines 
that read #tundef isinf and #undef isnan 


CAANADUNAPWNKFK TU AANA ADUNFwWN 
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Program 15.2: A program to divide two numbers and illustrate basic exception han- 
dling. 


#include <iostream> 


using namespace std; 


int main() { 
double x,y; 
tEy 


} 


Coutts <= VEntern mMumneratornce 
Giller SS Sep 

Goune << Vince cleiovemialieverceies Ws 
ean Pee aes 


if (y==0.) throw x; 


Clowlie KK ox <a W chinvalclercl loys “<< ay KK MW ales WT exe sey «<< iavelil.s 


catch (double top) { 


I 


cerr << "Unable to divide * << top << " by zero” << endl; 


cour <a. "Thank you for cividing.” <<-endip 


return 0; 





After some initialization, we encounter the try block (lines 7-16). Within this 
block, we prompt the user for two real numbers. Then, just before we divide, we test 
if the denominator is zero. At this point there are two possible ways the program 
might proceed. 


e If the denominator is zero, the exception is thrown (line 13). In this case, we 


throw the value of the numerator. The remaining statements inside the try 
block are skipped; line 15 is not executed. 


At this point, the computer skips to the end of the try block and searches 
for a catch statement whose type agrees with the type of the object that was 
thrown. Because throw x; throws a double value, execution proceeds to the 
catch statement on line 17. The variable top named in the catch statement 
is set equal to the value thrown (the value held in x). 


Now the statements embedded inside the catch block execute. In this exam- 
ple, there is only one statement (line 18) that prints an error message on the 
screen. 


Once the catch block is finished, execution continues at line 21. 


Alternatively, if the denominator is not zero, then the throw statement on 
line 13 does not execute. Instead, the program continues with the remaining 
statements inside the t ry block. In this example, there is only one more state- 
ment (line 15). 
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Because no exception was thrown, the catch block is skipped, and execution 
proceeds to the statements following the t ry block—that is, to line 21. 


Here are two runs of the program to illustrate how this works. 





cr 


Enter numerator: 17 
Enter denominator: 4 
17 divided by 4 is 4.25 
Thank you for dividing. 














S 
Enter numerator: —9.8 
Enter denominator: 0 
Unable to divide -9.8 by zero 
Thank you for dividing. 
s 





For this example, it would be simpler to use an if/then/else construction. The 
exception-throwing mechanism is particularly useful when the exception is thrown 
by one procedure and caught by another. We illustrate this idea in the following 
program. 





Program 15.3: A program to illustrate catching exceptions thrown by other proce- 
dures. 


#include <iostream> 
using namespace std; 


double quotient (double p, double q) { 
if (q==0.) throw p; 
return p/q; 


int main() { 
double x,y; 
try { 
Cou << Mingheeye iowiiteccicoies We 
Calin SS sp 
COU SEC tee Gloin@mielsiacite © terme 
CON We ima ge 


double q = quotient (x,y); 
COUL Se Se <e0 reread iy 9 a ye ae Nee ee end ly 
} 
catch (double top) { 
coir <= "Unable to divides " << top <<" By zero" << endl; 
esxerimten (18) 


Coul << “Thank you for cividing." << endl; 


return 0; 
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This program defines a procedure named quotient (see lines 5-8) that takes two 
double arguments and returns their quotient. If this procedure is invoked with q 
equal to zero, then the quotient is undefined. In this case, the procedure throws an 
exception. Notice that there is no try/catch block in the quotient procedure; it is 
the responsibility of the procedure that invokes quotient (in this example, main) 
to handle the exception. 


Inside main, the call to quotient is embedded in a try block (lines 12-21). If 
quotient runs normally (1.e., its second argument is not zero), then line 18 executes 
normally. Execution then proceeds to line 20, then the catch block (lines 22—25) is 
skipped, and the program continues at line 27. 


However, if (at line 18), the second argument sent to quotient is zero, then 
quotient throws an exception. The value of the numerator is thrown. The rest of 
the try block is skipped; that is, line 20 is not executed. At this point the computer 
searches for a catch statement whose type matches the type of the thrown value. 
Because a double value is thrown by quotient, it is caught at line 22. Now the 
catch block executes with top set equal to the thrown value. An error message is 
printed (line 23) followed by a call to a system procedure named exit. This causes 
the program to stop executing immediately. Consequently, the statements following 
the catch block—statements that would typically execute were it not for the call to 
exit—are not executed. 


If possible, the catch block should repair any damage caused by the exceptional 
situation so the program can continue running. However, some errors are sufficiently 
serious that continued execution does not make sense. In that case, a call to exit 
causes the program to stop running. Note that exit can be called inside any proce- 
dure (not just in main). 


The exit procedure takes an integer valued argument; this value is passed back 
to the operating system. If your C++ program is invoked by a script, the script can 
use that value to detect that something unusual occurred during the execution of the 
C++ program. By convention, a return value of 0 signals normal execution. That 
is why we end our main programs with the statement return 0;. However, if the 
program is forced to stop executing inside a procedure other than main, then exit 
can be used to return a value to the operating system. 


Here are two runs of Program 15.3. 





Enter numerator: 10 
Enter denominator: 4 
10 divided by 4 is 2.5 
Thank you for dividing. 











Enter numerator: -10 
Enter denominator: 0 
Unable to divide -10 by zero 
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15.3.2 Other features of the exception-handling system 
Multiple catches 


A try block must be followed by a catch block. However, there may be more 
than one catch block, provided each catches a different type. The general structure 
looks like this: 


try { 
// code that might generate exceptions 


catch (type_1 x1) { 
// nandle this exception 


catch (type_2 x2) { 
// nandle this exception 


catch (type_n xn) { 
// nandle this exception 





// vest of the code 


If an exception is thrown in the try block, it is caught by the catch block that 
matches the type of the object that was thrown. That, and only that, catch block is 
executed; the other catch blocks are skipped. Of course, if no exception is thrown, 
none of the catch blocks executes. 


Uncaught exceptions and a catch-all block 


It is important that there be a catch block for every type of exception that might 
be thrown by a try block. Otherwise, the uncaught exception causes the program to 
terminate by calling the system procedure abort. The abort procedure is a more 
drastic version of exit. abort takes no arguments and prints a message such as 
Abort trap on the screen. 

It is conceivable that you might not know every type of exception your program 
might produce. For example, you may be using a package you downloaded and 
you might not be familiar with the various exceptions that package’s procedures can 
produce. In such a case, you can create a catch-all block that catches any exception. 
Here’s how: after the various known exceptions, create a block that looks like this, 
catch(...) { 

// code to handle an exception of an unknown type 
} 

It is difficult for a catch-all block to handle errors because any information contained 
in the thrown object is lost; unlike a typical catch block, there is no value sent to a 
catch-all block. 


Objects to throw 


Any C++ object may be thrown by a throw statement. If you were to create your 
own arc sine function, it would be natural to throw an exception if the argument to 
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the function were outside the interval [—1,1]. In this case, it would be sensible to 
throw the argument of the function so the calling procedure knows that it sent an 
illegal value. 

Alternatively, we can throw an object specifically designed to convey detailed in- 
formation on the error. For example, we can create a class named TrigException 
like this: 





class TrigException { 
public: 
double value; 
string message; 


di 
Then our arc sine function would have the following form. 


double arc_sin(double x) { 


LE ((ee—l.) [|] deeb): 4 
TrigException err; 
err.value = x; 
err.message = "Argument to arc_sin not in [-1,1]"; 


throw err; 
} 


// calculate the arc sine of x, etc. 


} 


A procedure that calls arc_sin, or other trigonometric functions of our own cre- 
ation, can be structured like this: 
try { 
// various trig calculations 
: 
catch (TrigException E) { 
cerr << "Trouble occurred during the calculation" << endl; 
cerr << E.message << endl; 
cerr << "The faulty argument was " << E.value << endl; 
exit(1); 


Packages you download from the Web might contain their own exception types. 
For example, a geometry package might include a procedure to find the point of 
intersection of two lines. What should such a procedure do when presented with a 
pair of parallel lines? A sensible answer is to throw an exception. 


Rethrowing exceptions 


It is possible for a procedure to throw an exception, catch it, partially handle the 
exception, and then rethrow the exception to be handled by another procedure. It 
is unlikely that you will need this feature for mathematical work. Nevertheless, we 
describe how this is done. 

A catch block that both handles an exception and also passes that exception on 
is structured like this: 


catch(type x) { 
// nandle the exception 
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throw; 


} 


When this catch is invoked, the various statements in the catch block are executed. 
Finally, the statement throw; is reached; this causes the original exception that was 
caught to be thrown again. 


The keyword throw in a procedure declaration 


When you write a procedure that throws exceptions, it is advisable to announce 
explicitly the types of exceptions that might be thrown. This is done immediately 
after the argument list as in the following example. 


double quotient (double p, double q) throw(double) { 
if (q==0.) throw p; 
return p/q; 

} 


If a procedure throws more than one type of exception, we list the various types 
within the parentheses like this: 
return_type proc_name(typel pl, type2 p2, ..., typeN pN) 


throw(xtypel, xtype2, ..., xtypeM) { 
// the procedure 


The addition of a throw list to the introduction of a procedure makes it clear to 
the user of the procedure what kinds of exceptions the procedure might throw. Users 
of the procedure need only inspect the first line to deduce this information and do 
not need to hunt through the code for the various places an exception is generated. 

Exceptions that are not listed on the list of throw types cannot escape from the 
procedure. Either they must be caught inside the procedure or they trigger a runtime 
error. 





15.4 Friends 


Private data members of a class are accessible to the class’s methods; other proce- 
dures cannot inspect or modify these values. This is the essence of data hiding and 
it protects objects from being corrupted. When you use a class, you do not interact 
directly with its data, but only use its public methods. 

However, when you create a class, it may be useful to create some procedures that 
are permitted to access the class’s private elements. For example, recall the Point 
class of Chapter 6. In addition to the various methods (member procedures of the 
class), we also defined the procedures dist and midpoint. Neither of these is a 
member of the class Point, and so they need to use get X and gety to learn their 
arguments’ coordinates. C++ provides a mechanism by which midpoint and dist 
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can bypass data hiding; we do this by declaring these procedures friends of the class 
Point. 

The original header file for the Point class, Point .h, is given in Program 6.1. 
Here we present an alternative version in which dist and midpoint are declared to 
be friends of the Point class. 





Program 15.4: A new Point .h header with friend procedures. 


#ifndef POINT_H 
#define POINT_H 
#include <iostream> 
using namespace std; 


class Point { 


private: 
double x; 
double y; 


puloeiker 
Pyeanine: (()) 2 
Point (double xx, double yy); 
double getX() const; 
double getY() const; 
void setX(double xx); 
void setY(double yy); 
double getR() const; 
void setR(double r); 
double getA() const; 
void setA(double theta); 
void rotate(double theta); 
bool operator==(const Point& Q) const; 
bool operator!=(const Point& Q) const; 





friend double dist({Point. P, Point Q); 
friend Point midpoint (Point P, Point Q); 


}; 





ostream& operator<<(ostream& os, const Pointé& P); 


#endif 





Notice that dist and double are now declared inside the Point class declara- 
tion, and their declarations begin with the keyword friend. The friend keyword 
signals that they are not Point class members (i.e., methods), but rather privileged 
procedures that are permitted to access the private elements of Point. 

With this header in place, the definitions of dist and midpoint (in the file 
Point .cc) look like this: 
double dist (Point P, Point Q) { 

double dx = P.x - Q.x; 


double dy = P.y - Q.y; 
return sqrt (dx*dx + dyxdy); 
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} 


Point midpoint (Point P, Point Q) { 
double xx = ( P.x + Q.x ) / 2; 
double yy = ( P.y + Q.y ) / 2; 
return Point (xx,yy); 


} 


Efficiency 


By coding the midpoint and dist procedures as friends of the Point class, we 
can bypass the calls to get x and get y. Consequently, these procedures should be 
faster than the standard (nonfriend) versions. 

Another way to improve performance is to code these procedures to use call by 
reference (instead of call by value). In that case, the midpoint procedure would 
begin like this: 


Point midpoint (const Pointé P, const Pointé& Q) 


To send a Point object by value requires the transmission of two doub1e values; this 
comprises more bytes than call by reference where only a reference to the parameters 
needs to be sent to the procedure. 

Let us experiment with the effects of these differences. Let us write a program 
that generates a long list of points and then finds the midpoints for all pairs of points 
on the list. In this experiment, we use four different versions of midpoint: 


e A standard (nonfriend) version with call by value, 
e A standard version with call by reference, 
e A friend version with call by value, and 
e A friend version with call by reference. 
The results” of this experiment are summarized in the following chart: 


Time in seconds (no optimization) 





| Standard version | Friend version 
| Call by value 214 166 
a reference 
Call by ref 191 144 


























From these results, we observe that the friend version outperforms the corre- 
sponding standard version; this is thanks to the friend’s ability to access data ele- 
ments directly. We also observe that the call-by-reference versions outperform the 
corresponding call-by-value versions; this is thanks to the reduced number of bytes 
that need to be sent to the midpoint procedure. 


This experiment was performed on an 800 MHz G4 Mac OS X system using version 3.3 of the Gnu com- 
piler. The list of points contained 20,000 entries and so 400 million calls to midpoint were generated. 
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However, these results were obtained when none of the optimization options for 
the compiler was engaged. Modern compilers can deduce when a call to get X may 
be streamlined away and the private value can be safely sent directly into the proce- 
dure. Hence, when the experiment is repeated with all optimization options engaged, 
we get the following results. 


Time in seconds (full optimization) 





| Standard version | Friend version 


| Call by value 66 72 
| Call by reference 45 44 


























From this second experiment we observe that there is no advantage (in this in- 
stance) to setting up the procedures as friends, but we still achieve better performance 
using call by reference. 





15.5 Other ways to create types 
15.5.1 Structures 


C++ is an extension to the C language. The centerpiece of this extension is the 
concept of a class. An ancestor to the class concept is known as a structure. Like 
classes, structures are assemblies of data, and can be used as data types. However, 
structures consist only of data (no associated methods) and one cannot extend struc- 
tures using inheritance. 

Structures are declared in a manner that is similar to how we declare classes. This 
is how we declare a structure type that represents an ordered pair of real numbers: 


struct RealPair { 
double x; 
double y; 

}; 


With this in place, we may define variables of type RealPair, like this: 


RealPair p; 


Now, to access the data held in p, we use the familiar dot notation: P.x and P.y. 
You never need to use structures in your programming. The exact same behavior 
can be achieved using classes. Here is how RealPair would be declared. 


class RealPair { 
public: 
double x; 
double y; 
}; 
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15.5.2. Enumerations 


An enumeration is a variation on the integer data types. Suppose our program 
deals with different sorts of infinity. In the context of real numbers, we might have 
separate +°o and —ce, but in the context of complex numbers we have a single “com- 
plex infinity.” 

In C++ we can create a type to represent these three options. The syntax looks 
like this: 


enum infinity { minusInfinity, plusInfinity, complexInfinity }; 


With this in place, infinity becomes a type and variables may be declared to be of 
type infinity: 


infinity X; 


Now X may be assigned one of the three values declared in the enumeration; for 
example, X = plusInfinity;. 

Behind the scenes, the enumeration values (listed between the curly braces) are 
given integer values. Therefore, enumeration types may be used in switch state- 
ments: 


switch(X) { 

case minusInfinity: 
// action 
break; 

case plusInfinity: 
// action 
break; 

case complexInfinity: 
// action 
break; 


} 


It is not necessary to use enumeration types. The same effect can be achieved with 
constant integer values: 
const int minusInfinity = 0; 


const int plusInfinity = 1; 
const int complexInfinity = 2; 


Using enumerations does have some advantages. If you decide to add an addition 
kind of infinity, then you just add that new value to the enumeration list. If a variable 
is declared to be an enumeration type, then the compiler will complain if you attempt 
to assign a value to that variable that isn’t one of the allowed enumeration values. 
This can help prevent errors. 


15.5.3 Unions 


A union is a data structure that allows different types of data to be held in the same 
location in the computer’s memory. It is a trick that is designed to save memory. You 
should not use these things. We mention how they work just for your amusement. 
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A union is a type (like classes, structures, and enumerations). To declare a union 
that may hold an integer or a double value, you write this: 
union number { 

double x; 

long if 
hi 


Now we can declare a variable to be of type number: 


number Z; 


The variable z can hold only one data value, but that value may be either a double or 
a long. For example, to assign a real value to Z we write, for example, Z.x=0.12;. 
Or we can assign an integer value like this: z.i=-11;. 

What happens if we assign a value to a union using one of its types and then access 
its value using another? This is just begging for trouble. The value extracted is bound 
to be garbage. Consider this program. 


#include <iostream> 
using namespace std; 


union number { 
double x; 
long i; 

}; 


main() { 
number Z; 
Z.x = sqrt(2.); 
cout << "Z.x = " << Z.x << endl; 
cout << "Z.i = " << Z.i << endl; 
return 0; 


} 


When run, it produces the following output. 





Z.x = 1.41421 
Z.i = 1073127582 





15.5.4 Using typedef 


The keyword typedef is used to define synonyms for existing types. For ex- 
ample, rather than using double and long to declare variables, we mathematicians 
might prefer to use the single letters R and Z instead. To do this we use the following 
statements, 


typedef double R; 
typedef long Z; 


The newly defined names may save you a lot of typing. For example, instead of 
writing complex<double> to declare complex variables, we can use a typedef: 


typedef complex<double> C; 
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Choosing different names for types can improve the readability of your code and 
save you a bit of typing. In addition, using your own type names may prove invalu- 
able when revising your code. Suppose, for example, you initially used typedef to 
make R a new name for double. Subsequently, you find that you don’t really need 
the accuracy of double variables and that your arrays are too large for your com- 
puter. So you decide to use float variables instead. All you need to do is to edit the 
single line typedef double R; toread typedef float R; and recompile your 
code. 





15.6 Pointers 


Our approach to C++ has scrupulously avoided pointers. We have been able to do 
this for two reasons. First, call by reference obviates much of the need to use point- 
ers. Second, pointers are often used to create intricate data structures. Fortunately, 
the Standard Template Library provides a sufficiently rich assortment of ready-made 
structures, that it is not necessary for us to make new ones. In short, we simply don’t 
need pointers for our work.* 

However, pointers are used by many C++ programmers, and a package that you 
might download from the Web may require you to use pointers. We therefore close 
our exploration of C++ with an overview of pointers. 


15.6.1 Pointer basics 


An ordinary variable holds a value that represents an integer, a real number, a 
character, or an object of some class. A pointer is a variable whose value is a location 
in the computer’s memory. Given an ordinary variable, one can learn the address of 
that variable using the address-of operator, &. For example, if x is an int variable, 
then &x is the location in memory where the value is actually held. This is illustrated 
by the following program. 


#include <iostream> 
using namespace std; 


int main() { 
int x = 12; 
cout << "x = " << x << endl; 
cout << "&x = " << &x << endl; 


return 0; 


3The primary exception to this rule is the this pointer by which an object refers to itself. 
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The output of this program looks like this.* 





x = 12 
&X Oxbffff980 





By convention, memory addresses are expressed in base 16; the 0x prefix signals 
that the value is in hexadecimal. 

Pointer values can be saved in variables. In C++, every variable must have a type 
and we declare pointer variables using an asterisk «. If the pointer variable points to 
a location in memory holding a value of type base_type, then the pointer variable 
is declared to be of type base_type*. For example, if z is type double, then &z is 
type doubles. This is illustrated in the following program. 


#include <iostream> 
using namespace std; 


int main() { 
double z = 1.2; 
doublex zp; 
Zp = &Z; 


cout << "Zz "<< z << endl; 
cout << "zp = " << zp << endl; 
return 0; 





Zz =1.2 
zp Oxbffff980 





15.6.2 Dereferencing 


Suppose the pointer variable zp is type double (i.e., a pointer to a double 
value). We can use zp to inspect and to modify the value held in the memory location 
zp. The expression » zp stands for the value stored in the location to which zp points. 
So, if we have the statement cout << *zp;, the value held at location zp is printed. 
Similarly, the statement «zp = 3.2; changes the value held at location zp to 3.2, 
but does not change the pointer zp itself. These ideas are illustrated in the following 
example. 





Program 15.5: Illustrating pointer dereferencing. 


#include <iostream> 
using namespace std; 


suinne iqneialig ()) ff 


double z = 1.2; 


4If you run this program on your computer, the output might be different because the variable x might be 
stored at a different memory location. 
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doublex zp; 
Zp = &Z; 
Oe sar Mn eC pee ery 


Slonhe. <aS_ esea9) WK ere) SS isiovehl << Ginyelile 


*zp = MPI; 
COWS mcrae Ta ver ey 
Goue «<< Wy, et WN See de eS (euaVolILg 


return 0; 





On lines 9 and 10 we print the pointer itself and the value to which it refers. Then, 
on line 12, we use the pointer to modify the value pointed to by zp. Because zp 
points to the location that holds z, the value of z changes. Here is the output of the 
program. 





zp = Oxbffff980 
*zp = 1.2 

zp = Oxbffff980 
Zz = 3.14159 





The unary” operations « (address of) and » (pointer dereference) are inverses of 
each other. The first converts a variable into a pointer to that variable, and the second 
converts a pointer to a memory location to the value held at that location. 

Program 15.5 contains two hints about the perils of pointers. First, the variable 
z is modified by an expression that does not use the letter z (line 12). This makes 
the code more difficult to understand, more likely to contain bugs, and harder to 
debug. Second, if we neglected to initialize zp (line 7), then we don’t know where 
the pointer zp points. Consider this code. 


#include <iostream> 
using namespace std; 


int main() { 
double z = -1.1; 
double zp; 
*zp = 9.7; 
cout << "z = "<< z << endl; 
cout << "&z = " << &zZ << endl; 
cout -<< "ep = ' ee 2p <<. enal; 


cout << "*ezp " €< «zp <<. endl; 


return 0; 


>The operations & and * have different meanings when used as binary operations: bitwise-and and multi- 
plication. 
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When run on one computer we have the following result. 





r 


7 


Z = -1.1 
&z = Oxbffff980 
zp = Oxbffffa60 
*zp = 9.7 





Note that zp points to some unknown location (it does not point to z) and so the state- 
ment *zp = 9.7; changed some unpredictable location in the computer’s memory. 
When this program is run on another system, the following message is produced: 
Segmentation fault. This message was spawned by the statement *zp = 9.7; 
because, on this second computer, zp pointed to a memory location that was “off 
limits” to the program. (It is also possible to see the message Bus error; this also 
arises from using bad pointers.) This latter behavior is actually much better than the 
former because we see right away that something is wrong. In the first instance, no 
error Messages were generated; this type of bug is insidious and difficult to find. 


15.6.3. Arrays and pointer arithmetic 


AS we mentioned in Section 5.2, there is a connection between pointers and arrays. 
Recall that arrays can be declared in two ways. If, when we are writing our program, 
we know the size of the array, we declare it like this: 


int A[10]; 


However, if the size of the array cannot be determined until the program is run, we 
use new and delete[]: 


// determine the value of n 


int A; 

A = new int[n]; 
// use the array 
delete[] A; 


In this second case, the declaration of the variable A is indistinguishable from the 
declaration of a pointer-to-int variable. Indeed, in both cases, the variable A is a 
pointer. By convention, the name of an array is a pointer to the first element (index 0) 
of the array. This is illustrated by the following example. 


#include <iostream> 
using namespace std; 


int main() { 
int A[10]; 
for (int j=0; j<10; j++) A[Jj] = 10*j+5; 
cout << "The array is: "; 
for (int j=0; 3<10; J++) cout << A[j] << ""; 
cout << endl; 


cout << "A[0O] = " << A[0] << endl; 
cout << "A " << A << endl; 
cout << "«A = " << *A << endl; 
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The array is; 5 15 25 35 45 55 65 75 85 95. 


A[0] = 5 
A = Oxbffff950 
*A = 5 





The expressions A[0] and «A have exactly the same meaning. Both stand for the first 
element of the array and may be used interchangeably. Thus, if we want to change 
the first element of A to, say, 28, we may use either of the statements *A = 28; or 
A[0] = 28;. The second, however, is easier to understand and therefore preferable. 

Conversely, it is possible to use the subscript notation [] for pointers that were 
not created to be arrays. 


#include <iostream> 
using namespace std; 


int main() { 
int z= 23; 
int* A = &z; 


cout << A[0] << endl; 
cout << A[1] << endl; 


return 0; 





23 
-1073743488 





We see that A[ 0] yields the value 23. This follows from the fact that A [0] is identical 
to xA. However, for this example, the notation «A is preferable because A does not 
refer to an array. 

Which leads to the question: In this context, what is A[1]? To answer, we need to 
understand pointer arithmetic. 


Consider this program. 


#include <iostream> 
using namespace std; 


int main() { 


int z= 23; 
int* A = &z; 


cout << A << endl; 
cout << A+l << endl; 


return 0; 
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The first line of output shows that A equals Oxbff£££980. It would therefore make 
sense that the second output statement would produce Oxbffff981; that, however, 
is incorrect. Here is the output. 





OxbffF£980 
OxbffF£984 





We see that A+1 is 4 bigger than A. The reason adding one increases an int * pointer 
by 4 is that (at least on my computer) the size of an int is 4 bytes. That is, if A points 
to an int variable in the computer’s memory, then A+1 points to the next (possible) 
int. 

In general, one may add an integer to (or subtract an integer from) any pointer. If 
p is a pointer to an object of type T, then adding n to p causes the pointer to change 
by nX sizeof (T) bytes. Likewise, p++ increases p by sizeof (T) bytes. 

It does not make sense to add, to multiply, or to divide a pair of pointers. However, 
it does make sense to subtract a pair of pointers of the same type. The result is an 
integer value defined as the difference in bytes divided by the size of the kind of 
object to which the pointers point. The following code 


int a= 34; 
int b = 49; 
int* A = &a; 
int* B = &b; 


cout << B-A << endl; 


prints 1 on the screen. 

We now return to our discussion of arrays. An array A of objects of type T places 
the objects contiguously in memory. The location of A[1] is sizeof (T) bytes after 
the location of A[0]. Therefore, because A points to the first element of the array 
(i.e., to A[0]), A+1 points to the next element of the array (i.e., to A[1]). In general 
A+k points to A[k]. Ergo, 


A[k] is exactly the same as * (A+k). 


15.6.4 new and delete revisited 


In Section 5.5 we introduced the new and delete[] operators. These were used 
to allocate and to release space for arrays. Here we discuss a slightly different use of 
new and delete. 

Let T be a class. The usual way to declare a variable of type T is with a statement 
like this: 


Tx; 
We find such declarations inside the body of a procedure. Such variables are local to 
the procedure. Once the procedure terminates, the variable is lost. Variables declared 


in this usual manner are stored in a portion of the computer’s memory called the 
stack. 
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An alternative method for setting up a variable is to use new. If T is a type, we 
have the following statements, 
Tx xp; 
xp = new T; 
The new statement allocates sizeof (T) bytes of memory for a new object of type T. 
The zero-argument constructor (if any) is invoked when initializing the new object. 
Then, a pointer to that new object is assigned to xp. We may supply arguments to 
the type T constructor using this syntax: 


xp = new T(argl, arg2, ..., argN); 


When we use new (as opposed to the ordinary method of declaring variables) the 
memory for the object does not reside on the stack. Instead, it resides in a different 
portion of the computer’s memory called the heap. The practical difference is that 
the object defined using new persists even after the procedure in which it was created 
ends. 

Once the program is finished using an object created with new, the memory al- 
located to that object should be released. This is done with a delete statement: 


delete xp; 


Notice that the syntax here is slightly different from the situation in which we are 
freeing an array; in the latter case we use delete[]. The square brackets indicate 
that an entire of array of objects is being freed. 


Once an object is created using new, it can be used just as any other object. How- 
ever, we must remember that the variable xp is not of type T, but rather is a pointer 
to an object of type T. Therefore, if T has a method named, say, reset, it is an error 
to invoke this method with the expression xp.reset (). Instead, we should write 
(*xp) . reset (). Likewise, to access a data member of this object (say, it has a data 
element named a), we do not use the expression xp.a; rather, we write («xp) .a. 

There is an alternative way to write (*xp).reset() and («xp).a. The C++ 
operator —> is defined as follows. 


e xp->reset () Means (*xp) .reset (), and 
@ xp->a means (*xp) .a. 


The combination of a hyphen and a greater-than symbol is meant to look like an 
arrow pointing to the part of «xp we want. 


15.6.5 Why use pointers? 


There are a few situations in which pointers are useful, but in nearly all cases, 
one can do fine without them. Before call by reference was introduced into C++, 
procedures written in C that needed to modify their arguments used pointers instead 
of the values of the variables. For example, a procedure to swap the values of two 
double variables would be written like this: 
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void swap(double* a, doublex b) { 
double tmp = xa; 
xa = xb; 
*b = tmp; 

} 


To use this swap procedure on variables x and y of type double, we would write 
swap (&x, &y);. The ampersands are necessary because this version of swap re- 
quires pointer-to-double arguments. 

Similarly, suppose T is a class and that objects of type T are large (say, hundreds 
of bytes). Then each time we pass an object of type T to a procedure, the object 
is duplicated. Where possible, we can improve efficiency by passing a reference 
to the object instead of using call by value. Alternatively, we can declare the pro- 
cedure’s argument to be of type pointer-to-T. Passing a pointer is efficient, but we 
need to remember to pass the address of the object, and not the object itself. This is 
summarized in the following chart: 




















Declaration Invocation | Efficiency 
void proc(T x) {...} proc (x); slow 
void proc(const T& x) { ... } | proc(x); fast 

void proc(T* x) { ... } proc (&x); | fast 

















There is a natural way to avoid using new to create new instances of objects in 
the heap. Recall that primary purpose for doing this is to avoid passing large objects 
to and from a procedure. For example, a graph theory package would naturally 
include a procedure for partitioning the vertex set into connected components. This 
hypothetical procedure, named components, would take a single argument (of type 
Graph) and return a partition. The standard way to define such a procedure is like 
this: 


Partition components(Graph g) { 
Partition p; 
// 
return p; 


} 


Then, when we have the statement P = components (G) ; the computer would first 
make a copy of G (to be held in g inside the procedure). Then the Partition 
computed by the procedure (p) is copied back to the calling procedure to be saved in 
P. If the graph is large, this is highly inefficient. 

Some programmers would solve this problem by using pointers. In that paradigm, 
the procedure would look like this: 


Partition* components(Graph* gp) { 
Partition* pp; 
pp = new Partition; 
// 


return pp; 
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To invoke this procedure, we use a statement like this: P_ptr=components (&G) ;. 
Now G does not have to be copied; a pointer to G is all that needs to be sent to the 
procedure and a pointer to the newly calculated partition is all that needs to be sent 
back. It is then incumbent on the programmer to remember to delete pp; or else 
suffer a memory leak. 

There is a better, third alternative. We can use call-by-reference parameters to 
prevent repeated copying, and avoid pointers altogether. In this case, we define the 
procedure like this: 
void components (const Graph& g, Partitioné p) { 


// calculate p from g 
} 


In this case, we call the procedure with a statement of the form components (G, P) ;. 
The procedure would begin by erasing any data that happen to be in P and then 
overwriting with the new partition. 


Thankfully, there are hardly any situations in C++ that require the use of a pointer. 
You may be required to use pointers when using other people’s packages. An in- 
stance of this is the Standard Template Library’s sort procedure (see Section 7.4). 

Every method in a class may use a pointer named this. The this pointer refers 
to the object that invoked the method; that is, if we call x.method(), then method 
may use a pointer named this that points to x. This is handy if method modifies 
x and then wants to return a copy of x. This behavior is desirable when defining 
operators such as += for a class. See Section 6.8. 





15.7. Exercises 


15.1 Create a Card class to represent cards from a standard 52-card deck. The class 
should have the following features. 


e A zero-argument constructor that creates a default card (say, the ace of 
spades) and a two-argument constructor that sets the the value and suit 
of the card. The user should be able to create cards such as this: 


Card boss (ACE, SPADES) ; 
Card weak(2, CLUBS); 
e Comparison operators <, ==, and !=. 
e An operator<< for writing cards to the screen in English words, such as 
ace of spades Of four of diamonds. 
15.2 What is the difference between the following two statements? 


Tx xp = new T(10); 
Tx xp = new T[10]; 
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15.3 In Exercise 5.11 you were asked to create a program that repeatedly asked for 
large blocks of memory by using new without balancing calls to delete[]. 
When new is unable to allocate space (because memory has been exhausted), 
it throws an exception of type std: :bad_alloc. Revise your program so 
that it exits gracefully (instead of crashing) when memory is exhausted. 


15.4 C++ uses punctuation symbols for a variety of purposes. Many of these sym- 
bols serve multiple purposes in the language. For example, « is used for mul- 
tiplication and for declaring arrays (and for a few other purposes). In addition, 
these symbols can be doubled (e.g., & versus & &) or combined with others (e.g., 
!=) to form additional meanings. 


Find as many meanings for these symbols (either singly or in combination) as 
you can: 


+-x* /=<>! 6 | 


Don’t bother listing all of the combined arithmetic/assign operators such as +=. 
Classes may overload many of these symbols; list only the standard overloads. 


15.5 Create a class named Constructible to represent numbers that can be de- 
termined using the classical construction tools: straight edge and compass. 
Specifically, define constructible numbers recursively by declaring that all in- 
tegers are constructible; the sum, difference, product, and quotient® of con- 
structible numbers are constructible; and the square root of a constructible 
number is constructible. The complex numbers that can be built this way cor- 
respond to points in the plane that can be constructed using a straight edge, a 
compass, and a given unit length. 


The objects in this class should represent their numbers exactly. That is, the 


number 2+ \/5— V2 should be held as such, and not as a decimal (double) 
approximation. 


This class should include the following methods. 


e A zero-argument constructor to create the constructible number zero. 
e A one-argument constructor that takes a long integer argument. 

e A copy constructor. 

e A destructor. 

e An assignment operator. 


e The binary operators + - » / (either two Constructible arguments 
or a Constructible and a long integer) and unary -. 


e A sqrt () method that returns the square root of the constructible num- 
ber on which it was invoked. 


®Of course, division by zero is forbidden. 
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e A value() method that returns a complex<double> value giving the 
approximate decimal value of the constructible number. 


e An operator<< procedure that writes the number to an output stream 
in a suitable format such as TRX 


2+ Vsqrt{s = \sqrt{2}} 


or Mathematica 


2 + Sqrt[5 - Sqrt[2]] 
or some sensible method of your choosing. 


15.6 Tautology Checker. Create a program to check if Boolean expressions are tau- 
tologies. A Boolean expression is an algebraic expression involving variables 
(a, b, c,...) and logical operations (and, or, not, implies, iff, etc.). A tautology 
is a Boolean expression that evaluates to TRUE for all possible truth values of 
its variables. For example, ((x — y) \x) > y is a tautology. 


The program should be invoked either (a) with a command-line argument spec- 
ifying a file that contains the Boolean expression to be tested, or (b) with no 
command-line argument, in which case the user is prompted to type in the 
Boolean expression. 


The variable names may be any single lowercase letter (a to z). Use the fol- 
lowing for operation symbols. 





Symbol | Meaning 





+ or V 

* and A 

- not ~ 

> implies — 

< implied by — 


= equivalent <> 
0 TRUE 
1 FALSE 














Use reverse Polish notation (RPN) for the expressions (these are easier to 
process than ordinary algebraic expressions). For example, the expression 
((x > y) Ax) — y would be entered asx y > x * y >. Spaces are optional, 
so this may also be entered as xy>xxy>. 


It may be convenient for the user to enter an expression over several lines. The 
user should indicate that the expression is finished by typing a period. 


Part IV 


Appendices 


Appendix A 





Your C++ Computing Environment 


The methods by which you type, compile, and run programs varies between different 
computers with different operating systems. 
There are two broad approaches to this edit/compile/run process. 


e You use separate tools in terminal windows. That is, you type commands 
in a window to invoke an editor for creating and modifying your C++ files, 
type another command to compile your code, and another command to run the 
program. 


The code in this book was developed using the emacs editor and compiled 
using the g++ compiler. These tools are available for many computer systems 
(Windows, Macintosh, UNIX) and available for free from the Free Software 
Foundation (www. gnu.org). 


e You use an integrated development environment (IDE). This is a software ap- 
plication that provides a built-in text editor (for creating and modifying your 
code), a compiler, a debugger, and a means to run your program. Such envi- 
ronments include Microsoft’s Visual Studio on Windows computers, Apple’s 
Xcode on Macintosh OS X, KDevelop on Linux, and Metrowerk’s Code War- 
rior which runs on several platforms. 


Which approach you prefer is a matter of taste. The installation of these tools 
ranges from simple to complex. You may need some assistance from a friendly com- 
puter science colleague in getting started. If you can type in the code in Program 1.1, 
compile it, and run, then you are well under way! 

In this Appendix we provide specific advice to help you get started programming. 





A.1 Programming with a command window and a text editor 


In this approach your work is performed using two windows: a text editor and 
command shell. The specific tools we discuss come from the Gnu/UNIX world, but 
are available for Windows, Macintosh, Linux, and many other systems. It is possible 
that these tools are already present on your computer (especially if you are using 
Linux or some variation of UNIX). 
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A.1.1 What you need and how to get it (for free) 


To program in this manner you require the following. 


e A shell command window (running sh or one of its variants such as bash or 
csh). 


A text editor (the emacs or Xemacs editor, or some other editor designed for 
programming). 


e A C++ compiler (such as g++ from Gnu). 


e The make program to automate the compiling process (optional). 


The Doxygen program for creating Web-based documentation for your own 
program (optional). See Appendix B. 


If you are using a UNIX computer, these tools are likely to be already installed. 
For Windows and Macintosh users, you have the following options. 


Cygwin on Windows 


For Windows, we recommend that you install Cygwin (available for free from 
www.cygwin.com). This is a system that provides UNIX-like tools including the 
pieces you need: a bash terminal window, the g++ compiler, emacs and Xemacs 
text editors, and the make program. 

Follow the download and installation directions at the Cygwin Web site (see “Set- 
ting Up Cygwin’). 

Next, run the setup.exe program which presents you with a long list (separated 
into categories) of packages to install. Select the packages you want to install. We 
recommend the following. 
bash 
doxygen 
emacs 
emacs-X11 
gcc 
gcc=gtt 
make 
xemacs 
xorg-xl1l-xwin 
xterm 


The Cygwin setup program may install other packages that you did not select be- 
cause it understands how the packages you want depend on other packages. For ex- 
ample, selecting the xemacs package triggers the inclusion of other packages needed 
to provide the X-window environment. 

If all has gone well, new entries will be present in your Start menu, including an 
entry to start a bash shell: 


Start > Programs > Cygwin > Cygwin Bash Shell 
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Macintosh tools 


Macintosh OS X comes with many of the tools you need. For example, the Ter- 
minal application launches a bash shell. 

If X11 has not been installed (see the Utilities folder inside the Applications 
folder), then install it using the disks (CD/DVD-ROM) that came with your com- 
puter. 

You need the Developer Tools. Check if there is a folder named Developer at the 
top level of your hard drive (and be sure that inside that folder there is a subfolder 
named Applications containing the Xcode application). Alternatively, open a Termi- 
nal window and type the command: g++ --version. If the computer complains 
g++: command not found then you need to install the Developer Tools, but if it 
responds with the version of g++ installed, then you know that the compiler is al- 
ready installed on your computer. The make program should also be installed (try 
make --version). 

If the Developer Tools are not on your computer, they are either available on the 
disks that came with your computer or you can download them (for free) from Ap- 
ple’s Web site (developer. apple.com). Get a free membership to their Developer 
Connection, navigate to Developer Tools, and download Xcode. 

Next you need a text editor such as emacs. You can find Macintosh-style versions 
of emacs for free on the Web; see: 





http://home.att.ne.jp/alpha/z123/emacs-mac-e.html 


Finally, install the Doxygen application, available for free from doxygen.org. 
This is a standard Macintosh application that you install simply by dragging its icon 
to your Applications folder. (See Appendix B.) 


A.1.2 Editing program files 


To create the files for your C++ project you need a text editor such as emacs. Do 
not use a word processor, such as Microsoft Word, for this purpose. 

A good programming editor makes your life easier. As you type your program, 
the editor automatically indents lines of code the proper amount so you can see the 
structure. It also highlights keywords in color. If, for some reason, the editor does 
not indent your typing the distance you expect or a keyword does not appear in 
color, then you have a quick visual clue that you mistyped something. Smart text 
editors (such as emacs) detect what sort of file you are editing and place you into an 
appropriate mode! for that sort of file. 

Begin by creating a folder (directory) where you want to save your program. If 
you wish to use code you have already created for another project (or code from this 
book on the accompanying CD), you can copy the files you want into this directory. 


‘In emacs, editing a .h file places you in an editing mode meant for C, and not for C++. To switch to 
C++ mode, type: M-x c++-—mode where M—x means “meta-x”. 
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A typical C++ program has several files: .h header files and . cc code files. Save 
them all in the working directory you created. 

The emacs editor takes some practice because its conventions are different from 
other (non-UNIX) programs. The mouse-driven menus in emacs (or Xemacs) make 
getting started easier, but it is worth learning the keyboard shortcuts for common 
tasks including creating, opening, and saving files. I recommend you work through 
the tutorial that comes built in to emacs (available from the Help menu). 


A.1.3. Compiling and running your program 


By now you have created and saved your program in its own directory (folder) on 
your computer and you are ready to see if it works. Open a shell window” and nav- 
igate to your working directory. The shell command you need to change directories 
is cd (for change directory). Typing cd (and then pressing return) places you in your 
“home” directory. To move to a subdirectory type cd subdir where “subdir” is 
the name of the subdirectory. To move up a level in the hierarchy, type cd .. or to 
move to a directory directly, type the full path, like this: 


cd /home/barney/programming/twin-primes 


If you lose track of where you are in your computer’s file structure, the command 
pwd (for print working directory) reports your current location. 

One more useful shell command is 1s. The 1s command lists all the files in the 
current directory. 


Single file programs 


If your program consists of just a single file (e.g., poem.cc) then compile your 
program with this command: 


g++ poem.cc 


After a brief pause, one of two things happens. 


e With luck, the computer responds by typing the shell prompt (typically a sin- 
gle dollar sign $). This means that the program compiled without errors and 
created a ready-to-run program. Depending on your system, the program is 
named a.out (most UNIX systems) or a.exe (on Windows/Cygwin). 


e Or, more likely, the compiler types warnings and error messages. Unfortu- 
nately, these can be difficult to understand. The error messages usually report 
line numbers where the compiler got into trouble. However, that is not neces- 
sarily the line number where the programming error resides. You will quickly 
learn that an error reported for line n is often caused by a missing semicolon on 
line n— 1. Another common error is to forget the using namespace std; 
statement. 


Use a bash or similar shell window. If you are using Windows, do not open a DOS command window; 
instead, use the bash command terminal supplied by Cygwin. 
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When you get error messages, go back to your editor and figure out what’s 
wrong. Make some changes and try compiling again. 


When compiling is successful, the program is ready to run. In the shell window 
type 


-/a.out 


(or ./a.exe for Windows/Cygwin). The program runs and the output appears on 
the screen. 

If nothing appears to be happening and the shell prompt has not returned, your 
program may be stuck in an infinite loop. To force the program to stop, type a 
Control-C (while holding down the Control key on your keyboard, press the C key). 

You might not want to name your program a.out (or a.exe). You may either 
compile as described above and change the name of the executable, or you can com- 
pile with the following command, 


g++ poem.cc -o poem 


The -o poem option causes the compiler to write the executable program to a file 
named poem. (Use poem. exe for Windows.) 


Multiple file programs 


In most cases, your program spans multiple files. Typically, each class has a .h file 
and a .cc file. The main() procedure is in yet another file. For example, suppose 
your project consists of the following files: gcd.h, gcd.cc, Mod.h, Mod.cc, and 
main.cc. 

The simplest way to compile your program is with this shell command: 


g++ gcd.cc Mod.cc main.cc 


This compiles the program in these three source files and writes the executable to 
a.out (or a.exe). Alternatively, the shell command g++ «.cc compiles all files 
that end with .cc in the current directory. 

The .h files do not need to be mentioned in the compile command; they are auto- 
matically absorbed into the appropriate .cc files by the #include directives. 


If your project has just a few .cc files, then compiling them all with a single 
command works well. Imagine, however, that your project has ten different . cc files. 
You compile with the convenient g++ *.cc command, and the compiler complains 
about an error in one of the files. You fix the offending .cc file and compile again. 
The annoyance with this approach is that C++ compiling can be time consuming. 
So, rather than compiling all the . cc files at once, it is possible to compile them one 
at a time (fixing errors in each as you go), and then combine the pieces into a single 
executable program. Here is how you do this. 

Suppose the .cc files are named one.cc, two.cc, ..., nine.cc, and finally 
main.cc (which is the only source file that contains a main() procedure). To com- 
pile just the file one.cc type this: 


gt+ -c one.cc 
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The -c option tells the compiler that this is just a piece of the whole program, so 
don’t try to build a full executable a. out. Instead, the compiler creates a file named 
one.o. If there is a problem while compiling one.cc, we fix the error and compile 
this part again. This is much faster than recompiling all the files every time you 
modify just one of them. 

Of course, you also need to compile two. cc with the command g++ -c two.cc, 
and so on for all of the . cc files. 

Finally, you have collected several .o files that the computer needs to stitch to- 
gether to make the executable a. out (or a. exe). This phase is known as linking the 
object (.0) files. To link the .o files together, type this: 


gtt *.0 


Alternatively, you may name all of the . 0 files on the command line instead of using 
the wildcard «.o. You may also use the -o option to write the executable file to a 
different file name. 

If your project has just a few .cc files, then this technique is quite manageable. 
If you have many .cc files, then it is easy to lose track of which .o files are up 
to date with their corresponding .cc files. Fortunately, there is a good way to au- 
tomate this procedure using the make program. We describe this tool in a moment 
(see Appendix A.1.5) but first we introduce additional options you can give to the 
compiler. 


A.1.4 Compiler options 


In the previous section we introduced two options that can be used with the g++ 
compiler. The -o option is used to specify the name of the final executable program 
and the —c option is used to compile a .cc file just to a .o file and not to try to link 
the object files into an executable program. 

Here are some other options you can give to the g++ compiler. 


@ -Wall: This tells the compiler to issue all warnings. There are C++ statements 
that are not exactly errors, but are not fully legitimate C++. The compiler 
can proceed, but something is not quite right. With this option specified, all 
possible warnings are issued. 


It’s a good idea to use this option and fix your code so that all warnings disap- 
pear. 


e -ansi and -pedantic: These options disable nonstandard C++ features. 
Compiler manufacturers often include extensions to the standard C++ lan- 
guage. If you plan to use your program only on your own computer, then there 
is no serious problem in taking advantage of these nonstandard options. How- 
ever, if you try to compile your program on another computer with a different 
C++ compiler, these special features might not be available. By including 
these options you ensure the portability of your code. 
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@ -0, -02, and -03: These options engage the compiler’s optimizer. (Note: The 
O is the uppercase letter oh, and not the numeral zero.) Without these options, 
the computer compiles your code as quickly as possible, but does not produce 
the best possible (i.e., fastest) executable code. There are several “tricks” the 
compiler can apply during the compilation process and these options request 
greater and greater levels of optimization. The basic optimization is —o (which 
is equivalent to -01). Each of -02 and -03 employ additional optimization 
techniques. 


e -g: This causes the compiler to produce a program that can be run using a 
debugging tool (gdb). The gdb debugger is complicated to use and beyond 
the scope of this book. Some advice on debugging your code is presented in 
Appendix A.3. 


e -p and -pg: This causes the compiler to insert extra code in your program so 
that it can be analyzed with a profiling tool (prof and gprof, respectively). 
These tools measure how much time your program spends in each of its pro- 
cedures and how many times each procedure is called. If you need to make 
your program run faster, then this information tells you where to concentrate 
your efforts. 


e -1 directory: This option tells the compiler where to look for nonstandard 
header files. If you have downloaded and installed some special C++ package, 
you may need a #include directive for its header files. These header files 
might not be installed in a location that the C++ compiler knows to check. 
One solution to this problem is to copy the header files into your project’s 
directory. A better alternative is to tell the compiler where to find the special 
header files and for that you use the -1I option. (See the next bullet for more 
details.) 


e —Land -1 options: Packages that you download from the Internet may contain 
libraries—these are similar to .o files in that they contain compiled programs 
that can be linked into your final program. For example, the Gnu Multipreci- 
sion Package (GMP) is distributed with .h header files and libraries. One uses 
the -I option (described above) to specify the location of the .h files and the 
-L and -1 options to specify the location and name of the library. 


For example, on my computer the GMP header files are located in the directory 
/sw/include so if [have #include <gmpxx.h> in my program, I need the 
-I /sw/include option when I compile my programs. 


Furthermore, because the GMP procedures are embedded in a library, I need 
to tell the computer where the library is located (because on my computer, it’s 
in a nonstandard location) and the name of the library I need. The -L option 
specifies the location of the library. For my situation, I would type -L/sw/1ib 
to specify the location. The names of the GMP libraries are gmp and gmpxx 
(we need both when working in C++). To tell g++ to use these libraries, we 
use the options -lgmp -lgmpxx. 
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More details: The -I option is information for the compiler whereas the -L 
and -1 options are used by the linker. So if I were to compile the various 
source files of my program separately, the commands I use would look like 
this: 

gt+ -c alpha.cc -I /sw/include 

gt+ -c beta.cc -I /sw/include 

gt+ -c gamma.cc -I /sw/include 


gt+ -c main.cc -I /sw/include 
g++ *.0o -L/sw/lib -lgmp -lgmpxx -o my_program 


While writing and debugging your program, I recommend you use the -Wall, 
-ansi, and -pedantic options. Once the program is working properly, do a final 
compilation with -03. 


A.1.5 Introduction to make 


A program with just a few .cc files is easy to compile with a single command, 
either g++ *.ccor 


gt+ alpha.cc beta.cc gamma.cc main.cc -o myprog 


Alternatively, each piece can be individually compiled and the .o files linked with 
these commands: 
g++ -c alpha.cc 
g++ -c beta.cc 
g++ -c gamma.cc 


gt+ -c main.cc 
g++ alpha.o beta.o gamma.o main.o -o myprog 


However, if the project involves more .cc files, it is annoying to need to compile 
each .cc file separately, and difficult to remember which .cc files have been suc- 
cessfully compiled into the corresponding .o files. One is tempted to type g++ *.cc 
and endure the slow compilation process. 

Happily there is an alternative: The program make automates the entire process. 
To use make you create a file in your project directory named Makefile and then 
type make at the shell command prompt. 

A basic Makefile for compiling a program based on four .cc files (alpha.cc, 
beta.cc, gamma.cc, and main.cc) is presented in Program A.1. 





Program A.1: A basic Makefile. 


OBJS = alpha.o beta.o gamma.o main.o 
CXXFLAGS = -Wall -pedantic -ansi 


myprog: $(OBJS) 
Git S(OBUS) =o myprog 


clean: 
Tal I <5 46) 
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Line | defines the object (. 0) files that need to be created. Line 2 sets the options 
that g++ is to use when compiling the .cc files. 

Line 4 indicates that the program myprog depends on the files listed in oBJS. The 
syntax $ (OBJS) tells make that the variable OBJs is to be replaced by its value (i.e., 
the list of . 0 files on line 1). The program myprog is called a target and line 4 means 
that before myprog can be made, each of the files after the colon (1.e., the four .o 
files) must be made. 

Line 4 tells make on which files myprog depends, whereas line 5 tells make how 
to create the program myprog from the list of .o files. Notice that line 5 is indented; 
what you can’t see is that this indentation is caused by entering a TAB character 
into the file (and not by typing several spaces). The TAB is mandatory. Line 5 is 
equivalent to this: 


gt+t+ alpha.o beta.o gamma.o main.o -o myprog 


In other words, line 5 tells make how to link the object files into the executable 
program named myprog. 

(Ignore lines 7 and 8 for now.) 

Interestingly, there is no indication in the Makefile of how to create the .o files 
from the .cc files. That’s because make is smart enough to figure that out. It knows 
that if there is a file named alpha.cc in the working directory, then it is compiled 
into alpha.o using the command g++ -c alpha.cc. 

However, by setting the special make variable CXXFLAGS on line 2, make adds 
-Wall, -pedantic, and -ansi. 

With this Makefile in the same directory as alpha.cc, beta.cc, gamma.cc, 
and main.cc, we type make at the shell prompt. Here is what we see. 





cr 


7 


S$ make 

gt+t+ -Wall -pedantic -ansi -c -o alpha.o alpha.cc 
gt+t+ -Wall -pedantic -ansi -c -o beta.o beta.cc 
g++ -Wall -pedantic -ansi -c -O gamma.o gamma.cc 
gt+t+ -Wall -pedantic -ansi -c -O main.o main.cc 


g++ alpha.o beta.o gamma.o main.o -o myprog 





Now suppose we want to make a change to, say, beta.cc. If we type make again, 
this is what happens: 





g++ -Wall -pedantic -ansi -c -o beta.o beta.cc 
g++ alpha.o beta.o gamma.o main.o -o myprog 





Notice that only beta.cc is recompiled and then myprog is relinked. The other .o 
files do not need to be rebuilt, and they weren’t. 

If your project has many .cc files, they might not fit conveniently on a single line 
in the Makefile. You can use a backslash character \ to show that the definition of 
OBJS continues onto the next line, like this: 


OBJS = one.o two.o three.o four.o five.o six.o \ 
seven.o eight.o nine.o main.o 


Now let’s return to lines 7 and 8. Line 7 defines a target named clean with no 
dependencies and line 8 tells make what to do when we want to make clean. Line 8 
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causes the shell command rm (for remove) to delete all files that end with .o, that is, 
the object files. Once the program is functioning properly, we do not need the . o files 
and they can be removed. To cause this to happen, we simply type make clean. 

(Note: The standard way to run the make program is to type make target-name at 
the command prompt. However, if target-name is omitted, the first target found in 
the Makefile is built. Hence typing make or typing make myprog are the same for 
this Makefile. However, to cause make to run the commands for clean, we need 
to type make clean.) 

There are two other reasons why we might want to remove all the . o files. 


e Once the program is working properly, we may wish to recompile with —03 
added to line 2 of the Makefile. To force make to compile everything again, 
we type make clean and then make. 


e This simple Makefile cannot determine that .cc files may depend on .h 
files. A change to a .h file should be followed by a recompilation of all .cc 
files that #include it. It is possible to construct a more elaborate Makefile 
that deals with this issue, but a simpler solution is this: if you change header 
files, do amake clean followed by a make. 





A.2 Programming with an integrated development environment 


An integrated development environment (IDE for short) is a computer application 
that provides all the tools you need to write programs. It includes a text editor (for 
creating and modifying your .h and .cc files), a compiler, a debugger, and many 
other tools. They are extremely powerful and can be used to work on massive soft- 
ware engineering projects involving teams of programmers. These tools provide a 
dizzying array of menus and control buttons that can intimidate a novice program- 
mer. 

Fortunately, you can begin by using only a small fraction of the IDE’s capabilities. 
As your familiarity with the tool grows, you can gradually add more of its features 
to your repertoire. 

In this section we give a brief introduction to Microsoft Visual Studio (for Win- 
dows) and Xcode (for Macintosh OS X, available for free from Apple). 

Please note that software manufacturers regularly release new versions of their 
products. The new versions may have different features and the locations of menus 
and other controls may vary from version to version. 


Common features 


Visual Studio and Xcode share some basic organizing principles. In both you 
create projects. A project houses all the pieces you need for your program such as 
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.cc and .h files.? You either create these component files using the IDE’s built-in 
editor or you add files that have already been created elsewhere (via an Add menu 
item). Once the files are written and incorporated into the project, one builds the 
project; this means compiling the various source files and creating an executable 
program. Next, we run the program (within the IDE environment) and observe the 
action in a terminal window. If any errors crop up during the build phase, the IDE 
provides a convenient way to jump to the problematic portion of the source file. 


Both IDEs provide a debugger. You set break points in the program; the break 
points cause the program to pause at the statement where they are set. While the 
program is suspended, you can inspect the values held in variables. You can then start 
the program running again. If a subsequent break point is reached (or the same break 
point is met again), you have another chance to inspect the contents of variables. 

Both IDEs have a concept of a build configuration. The different configurations set 
different options for how the project is to be built. By default, both provide configu- 
rations named Debug and Release. Typically, one works in the Debug configuration 
until the program is working as expected. Then one switches to Release for a final 
build. 


A.2.1 Visual C++ for Windows 


Visual Studio is a integrated development environment sold by Microsoft. Install 
this on your computer using the disks provided. 


Starting a new project 


Launching Visual Studio* brings you to a start page with a button labeled New 
Project that you should click. 

A “New Project” window opens with a list of project types (on the left) and tem- 
plates (on the right). Follow these steps. 


1. Select Visual C++ Projects from the left and then Win32 Console Project 
from the right. Type in a name and a location for your project in the lower 
portion of the box: the location is the full path name of a folder on your hard 
drive (e.g., C: \research\math-programs\). The name is the name you 
want to give to your project (e.g., twin-primes). Fill these in and click OK. 


2. A dialogue box appears; in the left of this box click on Application Settings. 
On the right, check Empty Project under Additional Options. Click Finish. 


3More complicated projects can include images, sounds, video, and the like. 
4You can launch Visual Studio from your Start menu. 
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Adding files to the project 


You are now ready to create your program files. From the File menu select Add 
New Item. A dialogue box opens from which you select either C++ File or Header 
File (and you can safely ignore all the other options). Choose the type of file and 
type in its name in the text box at the bottom of the window. Note that Visual Studio 
expects the name of your C++ source file to end with . cpp (and not .cc as we have 
been using in this book). Feel free to use whichever naming convention you prefer. 
Click OK. 

You can now start typing your program. Create additional source files by using 
Add New Item until you have created all the files you need. 

If there is a file already on your computer that you want to add to this project 
(perhaps a file you created in a different project), use the Add Existing Item menu® 
option. 

If you want to edit a file that is already in your project, double-click on its icon in 
the Solution Explorer on the right side of your screen. 


Compiling 


Once your source files are collected in your project, it’s time to compile. Under 
the Build menu, select Build Solution. This engages the compiler. As the compiler 
runs, it reports its progress in a window at the bottom of your screen. 

When the compiler finishes you see, with luck, a message that the build succeeded. 
More likely, however, there are errors in your program in which case a “Build Error 
Task List” appears in the bottom of your screen. Read the first error carefully and 
then double-click on it. Visual Studio opens the source file containing the error and 
takes you directly to the line at which it ran into trouble (which might not be the 
faulty line in your program). 

After you fix the first error on the Task List, you have two choices. You can 
proceed to fixing the second error or you can try to compile again. Sometimes fixing 
the first error also fixes several subsequent errors (e.g., if you forgot to declare a 
variable). In this case, rebuilding removes several errors from the Task List and 
helps you move efficiently to the next trouble spot. 

Iterate this process of building the project and fixing errors until no errors or warn- 
ings remain. 


Running and debugging your program 


Once the program compiles without errors, it’s time to start it running. To do this, 
go to the Debug menu and choose Start Without Debugging. When the program 
starts running, a terminal window opens showing the program’s output and provides a 
place for you to type any input the program requires. When the program finishes, the 


5Or from the Project menu. 
6 Available either in the File or Project menu. 
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message Press any key to continue is typed in the terminal window—press a 
key and the window closes.’ 

If your program is not behaving as you expected, then you need to find the error 
in your program. This is more difficult than fixing problems that arose during the 
compilation process. Fortunately, the debugger in Visual C++ is extremely helpful 
(also see the advice in Section A.3 later in this appendix). Open any of your C++ 
code files. To the immediate left of your program is a gray strip; click next to a 
statement in your program and a large red dot appears in this strip. You have just 
set a break point in your program. Place these break points wherever you want your 
program to pause. Now select Start from the Debug menu. The program runs until 
it reaches the first break point and then pauses. In the lower portion of the screen you 
can find a list of variables and their values. You can check these to be sure they are 
what you expect. When you are ready to continue, select Continue from the Debug 
menu. The program resumes, pausing again at the next break point. 

When running under the debugger, the terminal window closes immediately after 
the program ends (so you can’t see what was written to that window). To prevent 
this from happening either set a break point at the return 0; statement in main () 
or add these lines to the end of your main (): 


cout << "Program finished" << endl; 
cin.get(); 


Now when you run the terminal window does not disappear until you type a return 
after seeing your Program finished message. 


Final version 


Once your program compiles and runs without errors it is time to perform one 
final build. When Visual Studio starts a new project, the project is in a Debug config- 
uration. Now that our program is working, we switch to a Release configuration by 
pulling down the Build menu and selecting Configuration Manager. This opens a 
dialogue box whose topmost control is a pull-down menu of configurations. Switch 
this from “Debug” to “Release” and click the Close button. 

Having switched the configuration to Release, build the project again. Visual Stu- 
dio uses different compiler options for different configurations and, by default, the 
Release configuration has compiler optimizations enabled so the executable program 
runs faster. 

(Note: You can modify the compiler options for the Release configuration. Pull 
down the Project menu and select the Properties item for your project (the last 
item in this menu). Select the C/C++ tab on the left and then the Optimization 
subtab. Now, on the right, you find the various options that can be set to adjust the 
optimization. In general, choose optimizations that favor higher speed as opposed to 
smaller size.) 


Note: If you choose Start from the Debug menu, then the terminal window closes immediately after the 
program finishes running. 
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With the final version built, you do not have to use Visual Studio to run your 
program. Using the Windows, navigate to the directory that houses your project 
(e.g., C: \research\math-programs\twin-primes). Within this folder, open 
a folder named Release where you should find an executable file named (based 
on our illustration) twin-primes.exe. This file can be copied to any convenient 
location on your hard drive. You can run this program either by double-clicking it, or 
by opening a DOS command window, going to the appropriate director, and typing 
its name. 


A.2.2 Xcode for Macintosh OS X 
Starting a new project 


Launch Xcode® and select New Project from the File menu. Scroll until you reach 
the heading Command Line Utility under which you select C++ Tool; click Next. 
Type in a name for your project and select a directory (folder) in which this project 
is to reside. Click Finish. 

A project window opens. Notice that a main.cpp file is already present in the 
project. You may either edit this file (double-click its name to get started) or you can 
delete it: select the file (single-click on its name) and press the Delete key on your 
keyboard. Choose Delete References & Files and main.cpp is deleted from the 
project and from your hard drive. 


Adding files to the project 


You are now ready to create your program files. From the File menu select New 
Empty File. This opens a new window in which you can type your program (either 
aheader .h file or a code .cc file). 

Start typing and be sure to save your work. The first time you save you are 
prompted for a name and location for your file. Save your work inside the project 
folder. Next, the computer asks if you wish to add this file to your project; click Add 
to Project and then Add. 

If there is a file already on your computer that you want to add to this project 
(perhaps a file you created in a different project), select? Add to Project from the 
Project menu. Navigate until you find the file you want and then click Add. A 
second panel opens at the top of which is an option to Copy items into destination 
group’s folder (if needed). Click the check box next to this to indicate that you want 
a copy of the file made inside your project; then click Add. 

To edit a file that is already in your project, simply double-click on its name in the 
project window. 


8Launch Xcode by double-clicking on its icon. The Xcode application is not in the main Applications 
folder. Rather, use the Finder to navigate to the top level of your hard disk, open the Developer folder and 
then the Applications folder inside there. 

°Tf the Add to Project option is dimmed, click once on the name of your project just below the heading 
“Groups & Files” in the left portion of your main project window. 
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Compiling 


Once your source files are collected in your project, it’s time to compile. Click on 
the Build icon in the project window (or select Build from the Build menu) and the 
compiler gets to work. 

When the compiler finishes you see, with luck, the message “Build succeeded” at 
the bottom left of the project window. More likely, however, is that there are errors to 
fix. The number of errors found in each file is reported in the main project window. 
You should also see a small red stop sign (octagon) with a white X at the lower right 
corner of the project window; click on this to bring up a list of errors. As you click on 
each error, the lower portion of the window jumps to the trouble spot in the relevant 
file. 

After you repair the first error, you have two choices. You may proceed to fixing 
the second error or you can try to compile again. Sometimes fixing one mistake 
resolves subsequent errors; in this case, rebuilding removes several items at once 
and allows you to move efficiently to the next trouble spot. 

Iterate this process of building and fixing errors until no errors or warnings remain. 


Running and debugging your program 


Once the program compiles without errors, it’s time to run it. Simply click on 
the Build and Go button on the project window (or select Build and Run from the 
Build menu) and the program starts executing. A window opens to show you the 
output of the program and provide a place for you to type any input the program 
requires. 

If your program is not behaving as you expected, then you need to find the error(s) 
in your program. This is more difficult than fixing problems that arose during the 
compilation process. Fortunately, the debugger in Xcode is extremely helpful (also 
see the advice in Section A.3 later in this appendix). Open any of your C++ code 
files (by double-clicking its name in the project window). If you click in the left 
margin next to any of the statements in the code a small black arrow appears. This 
indicates that you have set a break point into the program. Place these break points 
wherever you want the program to pause. To remove a break point, simply click on 
It. 

Once the break points are set, choose Build and Debug from the Build menu. The 
program starts running and then stops at the first break point it encounters. A list of 
variables with their current values is displayed. If some of the variables are classes, 
you can inspect the data members (including private members) for those objects. 

Continue executing the program by pressing the Continue button on the debugger 
window. The program now resumes execution until it reaches another break point or 
the end of main(). 


Final version 


Once your program is functioning properly it is time to perform one final build. 
In the Project menu, find the Set Active Build Configuration submenu, and select 
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Release. 

Next select Edit Project Settings from the Project menu. A window appears with 
four panel selectors at the top; choose Build from these. Reading from the top of 
the page, there is a drop-down menu for “Configuration”’—choose “Release.” Next 
there is a drop-down menu labeled “Collection” —choose “Code Generation.” 

You should see a list of setting/value pairs. Find the “Optimization Level” setting 
and, using the up/down arrows to the right, set the optimization level to “Fastest 
[-O3].” 

Now close the Info window and click the Build button on the main project window. 
This creates a “release” version of your program. 

Once this final version is built, you do not have to run it in Xcode. Instead, you can 
find the executable program inside the project directory. (Open the project directory 
in the Finder, double-click the folder named “Build” and then the folder named “Re- 
lease.”) You may now either double-click the executable file you find there, or copy 
it to another location on your hard drive. Alternatively, you can open a Terminal win- 
dow and change to the directory containing the executable program. For example, 
if the project (and the program) is named say, poetry, you launch the program by 
typing . /poetry once you are inside the appropriate directory. 





A.3 General advice on debugging 


Finding mistakes in computer programs can be a frustrating painful experience. 
Here we present some advice for how to find errors in programs and some common 
pitfalls. 


e Keep procedures short. It can be difficult to understand what’s happening in 
a long procedure. Break long procedures into a few shorter ones. Then you 
can test each individual piece to make sure it behaves as expected. 


e Name and document your procedures with care. Suppose you have a pro- 
cedure declared like this: 


double my_proc(double x, double y, long 4); 


This may make perfect sense to you today, but when you return to your work 
after the weekend, you may be confused by what my_proc does and what its 
arguments represent. 


Liberally comment your code and use names that reflect the meaning of the 
symbols. 


e Print, print, print! Sprinkle your code with output statements to show the 
contents of variables at each point of the program. Here’s a handy way to do 
this. In each procedure, define a bool variable named DEBUG and wrap your 
debugging code in an if statement, like this: 
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int count_instances(const Groupé G) { 
const bool DEBUG = true; 


if (DEBUG) { 
cerr << "i = " << i << " and j =" << j << endl; 


} 


} 


Once this procedure is working, you can edit the first line of the procedure to 
read 


const DEBUG = false; 


thereby switching off all the debugging code you entered. 


Alternatively, if you are working with an IDE, you can set break points and 
inspect variables as the program runs. 


Be meticulous in your use of const. Suppose we have a procedure declared 
like this: 


int count_generators(const Groupé& G); 


If this procedure invokes a Group method on G that has not been flagged 
const, then—even if that method does not modify c—the compiler reports 
an error. 


Make sure all variables are declared. It is easy to forget to declare a variable 
or to misspell its name. 


Watch for memory leaks. If your class uses a destructor to free memory, you 
can insert debugging code into the class’s destructor so you can observe when 
(if) the destructor is doing its job. 


Turn on all warnings. There are legal C++ statements that, almost surely, are 
not what you intend. The C++ compiler may help you find such errors. Here 
is a classic example. 


#include <iostream> 
using namespace std; 


int main() { 
long a = 10; 
long b = 23; 
if (a=b) { 
cout << "They are equal" << endl; 
} 
return 0; 


} 


This program compiles without error and the output is the mystifying 





They are equal } 
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where clearly a and b do not hold equal values. 


However, by turning on warnings (e.g., with -wall in g++) we get the follow- 
ing warning message from the compiler concerning line 7 of the program: 


suggest parentheses around assignment used as truth value 


This is not an especially helpful message, but at least it does point us to line 7 
where, in fact, the problem lies. The a=b ought to be a==b. 


Remember the using namespace std; statement. If the compiler com- 
plains that it doesn’t know what cout is, then you probably forgot the using 
statement. 


Do not name your program test. This is a subtle problem that can be truly 
maddening. Suppose you name the following program test .cc and compile 
it as an executable named test: 

#include <iostream> 

using namespace std; 

int main() { 


cout << "Does it work?" << endl; 
return 0; 


The program compiles witout error and now you attempt to run it by typing 
test at the command prompt. What happens? Apparently nothing. The 
message Does it work? never appears on your screen. 


There is nothing wrong with the program. The problem is that UNIX comput- 
ers already contain a standard program named test. When you type test at 
the command prompt, that version of test is run (not yours). To make sure 
the test in the current directory is the one that is executed, type ./test at 
the command prompt. 


A way to avoid this problem is to name your program try or attempt. 


Appendix B 





Documentation with Doxygen 


Document your code 


Write a description for every class, method, and procedure you create. Explain 
what the input parameters represent (and what the valid ranges for these variables 
are) and what the output means. Include descriptions of what the variables inside the 
procedure mean. 

This vital step in programming takes a bit of effort, but ultimately saves you hours. 
Over time, you will develop a personal library of classes and procedures. At some 
point you will want to reuse a class or procedure you have already created. If you 
don’t document, you will spend nearly as much time trying to figure out what the 
procedure is for as it would take to rewrite it! 

The most likely reader of your comments is you. However, a colleague might 
learn that you have created a C++ class that he or she would like to use in another 
project. Your comments will make your colleague’s work much simpler (and your 
colleague won’t be repeatedly visiting your office asking you what the procedures 
do and what the parameters represent). 


The simplest way to document your code is to include C++ comments in the .h 
and .cc files. However, there is a variety of tools that—with scant extra effort— 
make your documentation much easier to use (and beautiful to behold as well). These 
tools scan your C++ files for specially structured comments that are used to create 
Web pages (or I4TRX documents) that are easy to use. 

In this appendix we describe one such tool: Doxygen (available for free down- 
load from www.doxygen.org). There you can find the source code and, more con- 
veniently, already compiled, ready-to-use versions for Windows, Mac OS X, and 
Linux. 

Doxygen is rich in features. The description we present here is just a primer, but 
is sufficient to get you started. 





B.1 Doxygen comments 


Doxygen reads your C++ source files (.cc and .h) and looks for specially struc- 
tured comments. A C++ single-line comment begins with a double slash // and a 
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multiline C++ comment is enclosed between /« and «/. Doxygen reads what you 
write in those comments. To tell Doxygen to read a particular comment begin either 
with a triple slash /// (for single-line comment) or with the sequence /*»* (for a 
multiple-line comment). 


B.1.1 Documenting files 


Each file (either .cc or .h) should begin with a brief comment explaining the 
file’s general purpose. Structure the comment like this: 
/[*x* 

* @file Polygon.h 


* @brief Declaration of the Polygon class 


*/ 


The tag @file gives the name of the file and the @brief tag gives a short description 
of what the file is for. Notice the double asterisk on the first line; Doxygen looks for 
this to process this comment. 

Note: The initial asterisks on lines 2 and 3 are optional and do not affect Doxy- 
gen’s output. These stars are useful to the human reader making this portion of the 
file stand out clearly as a comment. 


B.1.2 Documenting procedures 


Procedures are declared in a .h file and the full code is given in a .cc file. To 
document a procedure for processing by Doxygen, we place special comments before 
the procedure declaration in the .h file. 

We generally write two comments. The first is a short, single-line overview of 
what the procedure does. The second is a long, multiple-line description of the pro- 
cedure, its input arguments, and its return value. 

The brief comment begins with a triple slash ///. We follow this with a few words 
that describe the procedure. 

The long comment begins with /«* giving a more elaborate description of the 
procedure. This includes special tags to document the input parameters and the return 
value. Here is an example. 





Program B.1: Documenting a procedure for Doxygen. 


/// Number of real roots of a quadratic. 

[xx 

x* This procedure determines the number of real roots of a quadratic 
polynomial by examining its discriminant. 


@param b coefficient of x 

@param c constant term 
* @return the number of real roots of ax°2 + bx +c 
x/ 


Linte muccoes (clowlolle a, clololle Jo, ielotioile €)) 5 


* 
* 
* @param a coefficient of x-squared 
* 
* 
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Program B.1 is an excerpt from a header file (say, nroots.h). The brief descrip- 
tion (line 1) tells us the procedure’s purpose. 

The expanded comment (starting at line 2) provides more detail including a de- 
scription of the technique used. Following the description are tags that describe the 
input parameters (lines 6-8) and the return value (line 9). The input parameters are 
documented like this: 


@param param_name role of this input parameter 


The return value is documented with an @return tag that describes the value re- 
turned by this procedure. 

Note that the initial asterisks on lines 3—9 are optional and are ignored by Doxy- 
gen. They serve the human reader by showing that this stretch of the file is a com- 
ment. 

Finally, the declaration of the nroots procedure is given on line 11. 

The code for this procedure is in a separate . cc file. For the sake of completeness, 
we give it here. 


#include "nroots.h" 


int nroots(double a, double b, double c) { 
double d; // The discriminant of the quadratic 


ad = beb - 4.x*axc; 
// Check sign of the discriminant and return number of roots 


tf (> 0.5 4 
return 2; 

} 

if (d < 0.) { 
return 0; 


} 


return 1; 


} 


Note that there are no Doxygen comments here, however, there are ordinary com- 
ments to help the human reader understand the code. 


B.1.3 Documenting classes, data, and methods 


Classes and their members are documented for Doxygen in a manner similar to 
ordinary procedures. The class and its members receive a brief description and then 
a detailed description. Methods for the class have their parameters and return values 
(if any) documented as well. In addition, the data members should be documented. 

To illustrate these, we present a class named Polygon. The full .h file is presented 
in Program B.2. Notice that the file, the class, the class’s constructors and methods, 
and the class’s data elements all receive comments to be processed by Doxygen. For 
the data members, a brief description is sufficient, so we omit the detailed elabora- 
tion. 
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Notice that constructors and void methods (such as move_vertex) do not have 
an @return tag because these do not return a value. The method perimeter takes 


no arguments, so no @param tag is given. 





Program B.2: Documenting a class and its members for Doxygen. 
[xx 
* @file Polygon.h 
* @brief Declaration of the Polygon class 


*/ 


#ifndef _POLYGON_ 
#define _POLYGON_ 


#include <vector> 
#include "Point.h" 


/// Planar polygons 

[xx 
x The Polygon class represents a closed n-gon in the plane. The 
* vertices of the Polygon are held as a vector of Point objects. 
*/ 

class Polygon { 

private: 
/// Hold the vertices of the Polygon 
vector<Point> vertices; 


/// The number of points in the Polygon 
Ot: Tipsy 


parle) IL ake" g 
/// Default constructor 
[*x 
* This default constructor creates an empty Polygon, i.e., a 
* Polygon without any points. 
x/ 
Polygon (); 


/// Create a basic n-gon 


[*x 


x This creates a polygon with a specified number of points. The 


* points are placed evenly around the unit circle. 
* @param n the number of points. 
x/ 

Polyoon (sit oh sy 


//4/ AG ORV CONS ers Gisor 

[** 

x Creates an exact copy of another Polygon. 
x @param P the Polygon we’re copying 


x/ 

Polygon(const Polygon& P) { 
ino) = 12 cisyeyy 
vertices = P.vertices; 
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/// Move a vertex to a new location 

[*x* 

* Note: If an invalid vertex index is given, no change is made to 
POLS Pol eoar. 


* @param j index of the vertex we want to relocate 
* @param P new location for vertex j 
x/ 


void move_vertex(int j, Point P); 


/// Perimeter of this Polygon 

[*x* 

* If the Polygon has fewer than two vertices, its perimeter is 0. 
* If it consists of exactly two vertices, the perimeter is twice 
* the distance between those points. 


* @return the perimeter of this polygon 
x/ 
double perimeter() const; 
}; 


#endif 





For the sake of completeness, here is the . cc file that accompanies Polygon.h. 


[** 

* @file Polygon.cc 

* @brief Code for the Polygon class methods 
x/ 


#include "Polygon.h" 


Polygon::Polygon() { 
np = 0; 
vertices.clear(); 


Polygon::Polygon(int n) { 
// Tf n is negative, set n to be zero. 
if (n < 0) n=0; 


// If is zero, just clear the vertices data structure 
if (n==0) { 

np = 0; 

vertices.clear(); 

return; 


// At this point, n is positive 


np =n; // set number of points ton 
vertices.resize(n); // allocate enough room 


for (int k=0; k<n; k++) { 
double theta = (2*M_PI«k)/n; 
vertices[k] = Point (cos(theta),sin(theta) ); 
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} 


void Polygon::move_vertex(int j, Point P) { 
// Tf the index is invalid, no action is taken 


if ( (3<0) II (3 >= np) ) return; 
vertices[j] = P; 

} 

double Polygon::perimeter() const { 


// The perimeter is zero unless we have at least two points 
if (np <= 1) return 0.; 


double ans = 0.; // place to accumulate the distances 
// add up the distances between successive vertices 
for (int k=0; k<np-1; k++) { 

ans += dist (vertices[k],vertices[k+1]); 


} 


// Add in the distance between the first and last points 
ans += dist(vertices[0], vertices[np-1]); 


return ans; 


The only Doxygen comments in Polygon.cc are to document the file. Other, ordi- 
nary comments are included to clarify the code to a human reader. 





B.2. Using Doxygen 


If Doxygen is not already installed on your computer, download it from its Web 
site (www. doxygen.org) and install it according the instructions found there. 

You should also collect all the files for your project into a single folder (directory) 
on your computer. You probably have done this already. 

Now launch the Doxygen tool. You are presented with a graphical user interface 
(“GUI”) window that specifies the easy steps for you to follow. See Figure B.1. 


B.2.1 Configuring Doxygen 


The first step is to configure Doxygen. In the configuration process you set various 
options (and Ill give you recommendations on what to select) and then save the 
configuration as a file named Doxyfile. 

To begin the configuration process, click the Wizard... button. A new window 
opens with four tabs. See Figure B.2. The four tabs are named Project, Mode, 
Output, and Diagrams. Here’s how to complete each of these pages. 
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“eee Doxygen GUI frontend =" 


Step 1: Configure doxygen 





Choose one of the following ways to configure doxygen 
Step 2: Save the configuration file 


Status: not saved 


Step 3: Specify the directory from which to run doxygen 


Step 4: Run doxygen 














Start ) Status: not running _ Save log... ) 


Output produced by doxygen 














Figure B.1: Doxygen GUI window. 
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Provide some information about the project you are documenting 





Project name: 


Project version or id: 





Specify the directory to scan for source code 


Source code directory: ( Select... ) 


© Scan recursively 





Specify the directory where doxygen should put the generated documentation 


Destination directory: ( Select... ) 








GOD Caancet ) 


Figure B.2: Doxygen configuration panel. 
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On the Project page, type in a name for your project in the first field. If you 
desire, you can specify a project version in the second field. 


Next you specify the location of the source code (i.e., the full path name of the 
folder containing your .cc and .h files). Either type in the full path to your 
source folder in the text field, or use the first Select... button to navigate to 
the directory (and the Wizard fills in the field for you). 


If your source code is organized into various subfolders, check the Scan re- 
cursively box. Otherwise, you can leave this unchecked. 


Finally, specify the destination directory. This is the directory in which the 
beautifully formatted documentation is to reside. If you wish, this can be the 
same directory as the source code. As needed, Doxygen creates subdirecto- 
ries in which it places the documentation. For example, it creates an html 
subfolder for the Web pages. 


Now click to the Mode page. In the top portion, select the All entities but- 
ton. This tells Doxygen to create documentation for all parts of your program 
including private data members, and so on. 


Check the Include cross-referenced source code in the output box. This 
causes Doxygen to create Web pages that show your source code. (You can 
click on the documentation to look at the source code and click inside the 
source code to go back to the documentation. This is a handy feature.) 


Finally, click the Optimize for C++ output button. 


Now click to the Output page. Check the HTML box. Under that box ei- 
ther select plain HTML or with frames and navigation tree. If you are 
only building documentation for one procedure or a small class, then the plain 
HTML option is sufficient. However, if the project has more than one source 
file, select the with frames option. 


For now, leave the other options (LaTeX, Man pages, Rich Text Format, and 
XML) unchecked. Later, if you wish to explore these other output formats, 
you can change your selection. 


Finally, click to the Diagrams page. For now, select the No diagrams option. 
Later, you can explore the different kinds of diagrams that Doxygen can create 
for you. 


You are now finished using the Wizard, so click OK to return to the main Doxygen 
GUI window. 

You now proceed to Step 2 on the GUI: save the configuration file. When you 
click Save... you will be prompted to save the configuration in a directory. Choose 
the same directory as your code and use the file name Doxyfile. 

Doxygen is now configured for your project. All of Doxygen’s settings are saved 
in the file named Doxyfile in the same directory as your source code. 
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If, after you have saved the Doxyfile, you wish to modify your settings, select 
Load... in the Doxygen GUI to select the Doxyfile you wish to modify, and then 
use Wizard... to choose the new options. If you want finer control, you may modify 
the settings using the Expert... button. 


You are now ready to run Doxygen to generate the Web pages. 


B.2.2. Running Doxygen 


Continuing in the Doxygen GUI, Step 3 asks for a directory in which Doxygen is 
to run. Use the Select... button to navigate to the same directory that holds the code 
and holds the Doxyfile configuration file. 

Finally, press the Start button in Step 4. If all is well, a subfolder is created named 
html into which the Web pages for your documentation are deposited. Open this 
folder and double-click on index.html. You are greeted by a main page from which 
you can explore all the documented files, classes, procedures (functions), methods, 
and so forth. 

If there are mistakes in the formatting of your Doxygen comments, error messages 
appear in the box labeled Output produced by doxygen in the main GUI window. 


B.2.3. More features 


In this brief introduction to Doxygen we presented just a few of the documentation 
tags available. Reviewing tersely, we have seen: 


e @file and @brief document the overall purpose of a file, and 


e @param and @return to document the inputs and outputs of procedures and 
methods. 


Doxygen provides many other tags and we mention just a few of them here. 


e Cross references. Doxygen provides a tag named @see that you can use to 
insert a cross-reference to another procedure or method. 


e Sample code. It is useful to include a snippet of C++ code to illustrate how a 
procedure is used. To do this, enclose the code fragment between @code and 
@endcode, like this: 


/// Find the median 
[xx 


* 


This procedure finds the median value in an array of numbers. 


@param vals array of real numbers 
@param nels number of elements in the array 
@return the median value in the array 


x @code 

* double* values; 

x // allocate and populate the values array 
* m = median(values, n); 

x @endcode 

* 

* 

* 
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x/ 


double median(double+ vals, int nels); 


e Mathematical notation. It is possible to include mathematical formulas into 


the documentation using TEX. This requires that TREX be installed on your 
system. In TX, mathematical notation is enclosed between single dollar signs. 
For Doxygen, enclose your notation between @f$ tags, like this: 


/// Approximate the Riemann zeta function 

[*x* 

* This procedure calculates an approximation to the Riemann 

* zeta function by expanding @f$\zeta(s)=\sum_{k=1}*n 1/k*s@fS. 
* @param s argument to the zeta function 

x @param n number of terms in the series 

* @return an approximation to @f$\zeta(s) @f$ 

x/ 


double zeta(double s, int n); 


It is also possible to typeset displayed formulas enclosed in the tags @f [ and 
@f]. 


e Bugs. Sometimes programs don’t work properly and give incorrect results. 


Until you have your code working properly, you can flag what is wrong with a 
@bug tag. 


/// Group element powers 

[** 

* Given a Group element g and an integer n, calculate g7n. 
@bug This isn’t working for negative exponents. 


@param g an element of the group 

@param n the power to which we wish to raise g 
@return g multiplied by itself n times 

/ 


+ * + + OF 


e Author, date, and version. With the tags @author, @date, and @version you 


can flag who did what and when on a large-scale project. 


Many more Doxygen tags can be found in the Doxygen documentation (available 
online). 


In addition to Doxygen tags, it is possible to insert HTML code in your comments. 
For example, suppose you implemented an algorithm you found on a Web page in 
your code and you wish to give proper attribution to the source you consulted. You 
can include a link to that Web page like this: 


[*x* 


* Description of this procedure... 


be a, A, 


<p> 

The algorithm we use was invented by Ann Expert and is described 
<a href="http://www.math.major-univ.edu/~expert/algo.html">on 
this Web page</a>. 


Appendix C 





C++ Reference 


This appendix gives a brief review of the C++ language as developed in this book. 
After you have read this book, you can use this appendix as a refresher course. 





C.1 Variables and types 


All variables in C++ must be declared before they are used. The declaration spec- 
ified the type of data the variable holds. The type of a variable may be one of the 
fundamental types or a class. 


C.1.1 Fundamental types 


e Boolean: bool 
e Character: char 
e Integer: short, int, long, long long! 


e Real: float, double, long double 


The integer types may be preceded with the keyword unsigned to shift their range 
to nonnegative values. The long long and long double types might not exist on 
all systems. 


C.1.2 Standard classes/templates 


C++ provides a large collection of standard classes. Many of these require a 
#include directive to load the appropriate header file. 

For example, to work with complex numbers, we include the <complex> header. 
A typical complex number is declared complex<double> z; and a Gaussian inte- 
ger is declared complex<long> w;. 


'Use __int 64 in Visual Studio. 
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Character strings are handled most conveniently using the standard st ring class 
(see Chapter 14); use the header #include <string>. 

There is a variety of standard classes for input/output (see Chapter 14) and to serve 
as containers (see Chapter 8). 


C.1.3 Declaring variables 


The simplest declaration statement specifies the type of a variable: int j;. 

Two or more variables of the same type may be declared in a single statement: 
long a,b;. 

A variable may be given an initial value when it is declared: double x = 3.5;. 

A variable declared using a template class should include the type parameters 
between < and > symbols, like this: complex<double> z;. 

Class variables often take arguments (sent to the constructor methods) when de- 
clared: Mod a(3,10);. 


There are three natural locations for a variable declaration. 


e Inside the body of a procedure (such as main or aclass method). For example, 


int main() { 
double x; 


e Inside the declaration of a procedure or method. For example, 


long gcd(long a, long b) { 


} 


e Inside a looping control structure. For example, 


for (int k=0; k<10; k++) { 
cout << k << endl; 


} 


C.1.4 Static variables and scope 


Variables are created when they are declared and are lost when the section of the 
program in which they are declared finishes. Two different procedures (say, alpha 
and beta) may both declare a variable named x, but alpha’s x and beta’s x have 
nothing to do with each other. All variables are local to the procedure in which they 
are declared. (It is possible, but ill advised, to create global variables in C++. We 
don’t discuss how.) 

When a procedure finishes, the values held in its variables are lost unless the vari- 
ables are declared static. In this case, the value held in the variable is retained 
between calls to the procedure. 
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C.1.5 Constants and the keyword const 


If a variable is declared with a given value and the program never changes that 
value, then the variable should be declared const. For example, in a program that 
uses the Golden Mean, we would have this: const phi = (1.+sqrt(5.))/2.;. 

Arguments to procedures that are not modified by the procedure should be de- 
clared const. For example, suppose we create a procedure to calculate the sum of 
the elements in a set of integers. Because such a procedure does not modify the set, 
we declare it such as this: 


long sum(const set<long>é S) { 


} 


A third use of the keyword const is to certify that a method does not change the 
object on which it is invoked. For example, if we are creating a LineSegment class, 
a method that reports the length of the segment would not modify the segment. In 
the header file, say LineSegment .h, we would find this: 


class LineSegment { 
private: 

// variables to specify the segment 
public: 

// constructors, etc. 


double length() const; 
}; 


and in the program file, say LineSegment .cc, we find this: 


double LineSegment::length() const { 
// calculate and return the length 
} 


C.1.6 Arrays 


If the size of an array can be determined before the program is run, it may be 
declared like this: int alpha[20];. 

However, if the size of an array is unknown until the program is running, use a 
dynamically sized array like this: 
int ny 
cout << "Enter array size: "; 
cin >> n; 


int* alpha; 
alpha = new int[n]; 


delete[] alpha; 


Remember that every array allocated with new should be released with a delete[]. 
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C.2 Operations 


Here we describe the behavior of C++’s fundamental operations. Remember, how- 
ever, that classes can override these meanings (e.g., the << operator does input when 
used with cin but its fundamental use is to shift bits). 


C.2.1 Assignment 


The statement a=b; takes the value held in the variable b and places that value in 
the variable a. Assignment statements can be combined. The statement a=b=c; is 
equivalent to a= (b=c) ; and the effect is to take the value in c and store that value 
in both b and a. 


C.2.2 Arithmetic 


The basic arithmetic operators are +, -, x, and /. For integer types, the mod 
operator is . There is no exponentiation operator, but the pow and exp procedures 
fill this gap. 

The — operator can be used as a unary operator; this negates its argument. For 
example, if a holds the value 3, then b=—a; assigns to b the value —3 (leaving a 
unchanged). 

The arithmetic operators can be combined with assignment. For example, a+=b; 
is equivalent to a=atb;. 

For integer types, the operators ++ and -- cause the variable to which they are 
applied to increase (respectively, decrease) by one. There is a difference between 
++a and at++. Do not write code that exploits this subtlety. 


C.2.3. Comparison operators 


Numerical types can be compared for equality, inequality, and order using these 
operators: 


== f= < <= > >= 


The result of these operators is a value of type bool. 


C.2.4 Logical operators 
C++ provides the following operators for bool values, 


&& || : 


These are logical and, or, and not. 
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C.2.5 Bit operators 


The individual bits in an integer variable can be manipulated using the following 
operators, 


& | << >> 


These are (bitwise) and, or, not, exclusive or, left shift, and right shift. 


C.2.6 Potpourri 


Square brackets are the subscript operator, used to access elements of an array. 
The first element of an array has index 0. 


Parentheses are used for grouping, but also indicate the invocation of a procedure 
or method: y = alpha(x,n);. 

Dot (.) is the member-of operator used to specify a data member of method of a 
class: x.size() orthing.first. 


The question mark/colon trigraph is an abbreviated if/then statement. The state- 
ment a=q?b:c; assigns the value of b to a if qis true; otherwise (q is false) it assigns 
the value of c to a. 


The keyword sizeof is an operator that returns the number of bytes required to 
hold a type; for example, sizeof (double). 


The comma is used for separating procedure arguments and when declaring more 
than one variable of a given type (e.g., double x,y;). It also has the obscure pur- 
pose of combining two (or more) expressions into a single statement. For example, 
ina for loop, if we want to initialize two counters, we may have a code such as this: 


int a, b; 

for (a=N,b=0; a-b>0; a--,bt++) { 
// stuff to do 

} 


This initializes a with the value held in N and b with 0. 


The following operators are for working with pointers. 


Ampersand is the address-of operator. If x is an int variable, then &x returns a 
pointer to x of type int*. The ampersand is also used to specify call-by-reference 
semantics in procedures. 


Asterisk is the pointer dereferencing operator. If p is a pointer to an integer value, 
then «p is the value held in the location pointed to by p. 


The arrow operator, ->, combines the action of . and x. For example, if p is a 
pointer to an object, then p->x is equivalent to (*p) .x (the data element x of the 
object p points to) and p->alpha () is equivalent to («p) .alpha() (invoke method 
alpha on the object pointed to by p). 
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C.3. Control statements 


Statements in C++ must be terminated by a semicolon. Collections of statements 
can be grouped together to form a compound statement by enclosing those statements 
in curly braces. All statements enclosed in the curly braces must end in a semicolon, 
but the compound does not require a semicolon after the closing brace. (Exception: 
When defining a class, the closing semicolon must be followed by a semicolon.) 

Normally, statements are executed in the order encountered. However, various 
control structures may be used to modify this behavior. 


C.3.1 if-else 


The simplest form of this structure is this: 


if (expression) { 
statements; 


} 


Here, expression is evaluated. If its value is true, then the statements are 
executed; if false, then the statements are skipped. 
We also have the following richer form, 
if (expression) { 
statementsl; 
} 
else { 
statements2; 


} 


Again, expression is evaluated. If it yields true, then statements1 are executed 
and statements2 are skipped. Otherwise (expression evaluates to false) the 
opposite occurs: statements1 are skipped and statement s2 are executed. 

The ?: operator is a compact version of the if-else structure. 


C.3.2 Looping: for, while, and do 


The for statement has the following format, 


for (start_statement; test_expression; advance_statement) { 
work_statements; 


} 


This statement results in the following actions. First, the start_statement is exe- 
cuted. Then test_expression is evaluated; if false then the loop exits and con- 
trol passes to the statement following the close brace. Otherwise (test_expression 
is true), the work_statements are executed, then the advance_statement Is 
executed, and finally the test_expression is evaluated. If false, the loop exits 
and if true, the entire process repeats. 
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The while statement is structured as follows, 


while (test_expression) { 
work_statements; 


} 


The test_expression Is evaluated first and, if false, the work_statements 
are skipped and execution passes to the next statement after the close brace. Oth- 
erwise (test_expression is true), the work_statements are executed, then 
test_expression is re-evaluated and the process repeats. 


The do statement is structured as follows, 


do { 
work_statements; 
} while (test_expression); 


Here, the work_statements are executed first, and then the test_expression Is 
evaluated. If true, the process repeats; if false, the loop terminates. 


All three looping constructs (for, while, and do) support the use of the state- 
ments break; and continue;. A break; statement causes the loop to exit im- 
mediately. A continue; statement causes the loop to skip the remaining work 
statements and attempt the next loop (starting with test_expression). 


C.3.3° switch 


A switch statement controls execution depending on the value of an expression. 
The format is this: 


switch (expression) { 
case vall: 
statements1l; 
break; 


case val2: 
statements2; 
break; 


default: 
default_statements; 


} 


Here, expression is evaluated to yield an integer result. If there is a case statement 
whose label matches the value of expression, control passes to that point and the 
statements following the case label are executed until a break statement is reached. 
If no matching label can be found, then statements following the default label are 
executed. Groups of statements may be preceded with more than one label. 

The labels val1, val2, and so on, must be specific numbers (not variables). 
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C.3.4. goto 


C++ contains a goto statement whose syntax is goto label;. The causes exe- 
cution to pass to a statement that has been flagged with the name label. In general, 
the use of goto is discouraged as it can lead to unintelligible programs. However, 
one use is for breaking out of a double loop: 
for (int a=0; a<N; at++) { 

for (int b=0; b<N; bt+) { 

if (beta(a,b) < 0) goto aftermath; 
// other stuff 
} 
} 


aftermath: cout << "All finished" << endl; 


C.3.5 Exceptions 


The keywords try, throw, and catch are used to implement C++’s exception- 
handling mechanism. Typical code looks like this: 
try { 
statements; 
if (something_bad) throw x; 
more_statements; 
} 
catch(type z) { 
recovery_statements; 


} 


If something_bad is false, execution continues with more_statements and the 
recovery_statements are skipped. However, if something_bad evaluates to 
true, then more_statements are skipped and the value x is “thrown”. Assum- 
ing that x is of type type, the exception is “caught” by the catch statement and 
recovery_statements are executed. 

The statements inside the try block need not have an explicit throw statement; 
the procedures invoked inside this block may throw exceptions. See Section 15.3. 





C.4 Procedures 


Procedures (often called functions in the programming community) are subpro- 
grams designed to do a particular job. 

Procedures are declared by specifying a return type (if none, write void), followed 
by the procedure’s name, followed by a list of arguments (with their types). The value 
returned by the procedure is given by a return statement. 

Two procedures may have the same name provided they have different number 
and/or types of arguments. 
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C.4.1_ File organization 


In general, it is best to separate the declaration of a procedure from its definition. 
The declaration is placed in a header file (suffix .h) and the full definition is placed 
in a code file (suffix .cc). 

For example, suppose we wish to declare a procedure named nroots that returns 
the number of real roots of a quadratic polynomial ax? + bx +c. The header file 
would contain the following single line, 


int nroots(double a, double b, double c); 


The .cc file would contain the full specification: 


int nroots(double a, double b, double c) { 
double d = b*b —- 4.x*axc; 
if (d < 0.) return 0; 
if (d > 0.) return 2; 
return 1; 


C.4.2 Call by value versus call by reference 


By default, C++ procedures use call-by-value semantics. That is, when a proce- 
dure (such as nroots) is invoked, the values of the arguments in the calling proce- 
dure are copied to the local variables in the procedure. Although procedures may 
modify the copies of the arguments, the original values (in the parent procedure) are 
unaffected. 

However, variables can be designated to use call-by-reference semantics. This is 
indicated by inserting an ampersand between the type and the argument. In this case, 
a procedure can change a value from its calling procedure. 

Here is an example: 
void alpha(int x) { xt++; } 
void beta(int &x) { xt++; } 
int main() { 

int a = 5; 

int b = 5; 

alpha(a); 

beta (b); 

cout << a << endl; 

cout << b << endl; 


return 0; 


} 


The procedure alpha increases a copy of a, SO main’s a is unaffected. However, the 
procedure beta increases the variable b itself, so its value becomes 6. The output of 
this program is this: 





: 


Call by reference is useful if the objects passed to a procedure are large. Passing a 
reference is faster than making a copy of the object. 
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C.4.3. Array (and pointer) arguments 


When an array is passed to a procedure, C++ does not make a copy of the array; 
instead it sends a pointer to the first element of the array. 

For example, suppose we write a procedure to sum the elements in an array of 
double values. Here is the code. 


double sum(const double* array, long nels) { 
double ans = 0.; 
for (long j=0; j<nels; j++) ans += array[j]; 
return ans; 


} 


Here, nels specifies the number of elements in the array. No duplication of the 
array is made. Instead, a pointer to the first element is passed. One implication of 
this is that a procedure can modify the entries in an array argument. Because the sum 
example we presented here does not, in fact, modify the elements of the array, we 
certify that with the keyword const. 

More generally, a pointer can be passed to a procedure. In this case, the value 
pointed to by the pointer can be modified by the procedure. However, it is simpler to 
use reference arguments. 


C.4.4 Default values for arguments 


Arguments to procedures may be given default values. If an argument is given a 
default value, then all arguments to its right must also be given default values. For 
example: 


void example(int a, double x = 3.5, int n = 0) { 
} 


Calling example (4) is tantamount to example (4,3.5,0). 


C.4.5 Templates 


Earlier we considered a procedure to sum the elements in an array. This procedure 
works only for floating point (double) arrays. The identical code (but with different 
types) would be used for a procedure to sum an integer array. Rather than write 
different versions for each type of array, we can write a procedure template such as 
this: 
template <class T> 
T sum(const T* array, long nels) { 

T ans = T(0); 

for (long j=0; j<nels; j++) ans += array[j]; 


return ans; 


} 


In this example, the symbol T acts as a “type variable”—it may stand for any type. 
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C.4.6 inline procedures 


A procedure may be declared as inline; this causes the compiler to generate a 
different style of object code that uses more memory but runs faster. In general, it 
is not necessary to use this keyword because modern compilers automatically inline 
procedures when they determine it is advantageous to do so. 





C.5 Classes 


New data types are created in C++ through the use of classes and class templates. 
Various ready-to-use classes are provided with C++ such as string, vector, and 
complex. Other classes are available for download from the Web and from commer- 
cial software vendors. Finally, programmers can create their own classes. 


C.5.1 Overview and file organization 


Suppose we wish to create a class named MyClass. The specification for the 
class is broken across two files: MyClass.h contains a declaration of the class and 
MyClass.cc contains code for the class’s methods. 

The code in MyClass.h typically looks like this: 


class MyClass { 


private: 
// private data (and methods) 
public: 
MyClass(); // basic constructor 


// other constructors 


int methodl (double x, double y); 
// other methods 
}; 


In the file MyClass.cc we give the code for the constructors and other methods 
for the class, like this: 


#include "MyClass.h" 


MyClass::MyClass() { 
// code for the constructor 


} 


int MyClass::methodl (double x, double y) { 
// code for this method 
} 


Alternatively, code for constructors and methods may be given inline in the .h 
file. This is advisable when the code is only a few lines long. 
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Data and methods listed in the private section are accessible only to the methods 
inside the class (but see Appendix C.5.7). Data and methods listed in the public 
section are accessible to all parts of the program. 

It is wise to designate all data in a class private and to provide get/set methods to 
inspect/manipulate the data. 


C.5.2 Constructors and destructors 


A constructor is a class method that is invoked when an object of the class is 
created (e.g., when declared). Constructors do not have a return type, but may have 
arguments. 

Be sure to have a zero-argument constructor for your class. This constructor is 
invoked when a variable is declared in the simple form: MyClass x;. The object x 
is then initialized using the zero-argument constructor. 

Classes may have constructors with arguments. For example, if MyClass has a 
constructor with a single integer argument, then the declaration MyClass X(17); 
invokes that constructor. Such a constructor is also invoked in all the following 
situations. 


MyClass X; 
X = MyClass(17); 


MyClass Y = 17; 


MyClass Z; 
Z= 17; 


Some constructors allocate storage (with new). When such an object goes out of 
scope, the allocated memory needs to be recovered (or the program suffers a memory 
leak). To accomplish this, a destructor needs to be specified. In the -h file, a public 
method is declared like this: 


class MyClass { 
private: 

int*x BigTable; // table of numbers 
public: 

“MyClass(); // destructor declaration 
}; 
and in the .cc file: 
MyClass::~MyClass() { 


delete[] BigTable; // or other clean-up code 
} 


Alternatively, with a short destructor, the code may be written inline in the -h file. 
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C.5.3 Operators 


The usual C++ operators (such as + and ») apply to the built-in data types (int, 
double, and so on). These operators may also be used for classes by creating oper- 
ator methods and procedures. 

Suppose we wish to define + for objects of type MyClass; that is, if A and B are 
type MyClass, then we want to ascribe a meaning to A+B. Typically, we would 
declare a method within the body of the MyClass declaration (in the .h file) like 
this: 
class MyClass { 


private: 


public: 


MyClass operator+(const MyClass& Z) const; 
}; 


and in the .cc file give the code: 


#include "MyClass.h" 
MyClass MyClass::operator+(const MyClass& Z) const { 


} 


Then, when the compiler encounters the expression A+B, it applies the operator+ 
method for object A with object B passed (by reference) to Zz. 

(Note the double appearance of the keyword const. The first const certifies that 
this method does not modify the argument Z and the second certifies that this method 
does not modify the object on which it is invoked.) 

Alternatively, we could implement A+B with a procedure that is not a class method. 
In a .h file we declare the procedure like this: 


MyClass operator+(const MyClass& U, const MyClass& V); 


and in the corresponding .cc file we give the code: 


MyClass operator+(const MyClass& U, const MyClassé V) { 


} 
Unary operators (e.g., for negation) are declared as class methods like this: 


class MyClass { 


MyClass operator-() const; 
}; 


or as procedures like this: 
MyClass operator-(const MyClassé& U); 


Binary operators may be used to combine objects of different types. If the left 
operand of the operator is of type MyClass, then the operator may be defined as a 
method of MyClass. For example, for the operator MyClass+int, use this: 
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class MyClass { 


MyClass operator+(int j) const; 
}; 


However, for int+MyClass, a procedure needs to be declared like this: 


MyClass operator+(int j, const MyClassé& Z); 


The increment ++ and decrement -- operators have two forms: ++a and a++. We 
recommend defining only the prefix form. This is done with an class method like 
this: 
class MyClass { 


MyClass operator++(); 
}; 


(Note: Typically ++A is used to increase the value of A by one, so this method modi- 
fies A. That is why we do not include const after the parentheses.) 

It is possible to declare a postfix form of these operators. To do this, we give a 
“dummy” argument of type int like this: 


class MyClass { 


MyClass operator--(int x); 
}; 


C.5.4 Copy and assign 


If objects A and B are of type MyClass, then the expression A=B has a default 
meaning that can (and sometimes should) be overridden. 

The default meaning of A=B is to copy the data fields of B into the corresponding 
data fields of A. That is, if class MyClass has data fields x, y, and z, then A=B; has 
the effect of performing the three assignments 


A.x = B.x; A.y = B.y; A.Z = B.z; 


Finally, the new value of A is returned. 

This behavior is appropriate in many cases, especially if the data fields are the 
basic types. However, if one of these fields, say x, is an array, then the action 
A.x = B.x; does not copy the array B. x into A. x (as, presumably, we would want). 
Rather, it causes A. x to point to the same location in memory as B. x, so subsequent 
modifications to array elements in B.x are also applied to the array A.x because 
these arrays are now housed in the same memory. 

To achieve the desired behavior, we need to write a new assignment operator. The 
effect of this operator is to copy the data from B to A. In addition, an assignment 
operator should return the value of A (after it is updated). 

To do this, we declare an operator= method inside the class definition like this: 


class MyClass { 


C++ Reference 405 


MyClass operator=(const MyClass& Z); 
}; 


In the .cc file, the code looks like this: 


MyClass MyClass::operator(const MyClass& Z) { 
// set the fields x, y, and z 
// so they are duplicates of Z.x, Z.y, 2.z 
return «this; 


} 


The final return «this; statement causes a copy of the object to be the return 
value of this method; see Appendix C.5.6. 


Just as C++ provides a default assignment operator, it also provides a default copy 
constructor. The default behavior of the declaration MyClass A(B); (where B is 
a previously declared object of MyClass) is to do a field-by-field copy of B’s data 
into A. As in the case of assignment, this default behavior may be unacceptable. In 
such cases (e.g., when MyClass data includes an array), we must write our own copy 
constructor. 

To declare a copy constructor, we have the following in the .-h file, 


class MyClass { 


MyClass (MyClass& 2); 
}; 


and in the .cc file: 


MyClass::MyClass(MyClassé Z) { 

// set the fields x, y, and z 

// so they are duplicates of Z.x, Z.y,, Z.z 
} 


C.5.5 static data and methods 


In a typical class, each object of the class has its own values for each data field. 
Sometimes it is desirable to have a value that is shared among all objects in the 
class. For example, if we wish to keep track of how many objects of type MyClass 
are currently in existence, we can define a variable object_count that is shared 
among all objects of type MyClass. Constructors would increment this variable and 
destructors would decrement it. To distinguish variables that are shared among all 
objects from ordinary data members that are particular to each instance of the class, 
we use the keyword static. For example, in the .h file we have 


class MyClass { 
private: 


static int object_count; 

public: 
MyClass () { ...; object_count+t; } 
“MyClass() { ...; object_count--; } 


}; 
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and in the .cc file we have 
MyClass::object_count = 0; 


One may also have static methods. These are class methods that do not apply 
to any particular object, but to the class as a whole. They can only access static 
data in the class because the other data are particular to each object of the class. 

In the example above, we would want a method that reports how many objects of 
type MyClass currently exist. To that end, we add to the public section of MyClass 
the following method, 


static int get_object_count() { return object_count; } 


Because this method applies to the class MyClass and not to any particular object of 
that type, it is inappropriate to invoke it as A. get_object_count () (where A is of 
type MyClass). Rather, we write MyClass: :get_object_count (). 


C.5.6 this 


Class methods may access all data fields of the object on which they are invoked. 
On occasion, it is useful for a method to refer to the entire object on which it was 
invoked. For example, when we define ++A (by declaring an operator++), the 
conventional return value of this operator is the new value assigned to the object. 

To do this, C++ provides a pointer named this. The this pointer refers to the 
object on which it is invoked. Suppose MyClass has a method named work. If we 
use the pointer this inside of work, then this is a pointer to the object Aand «this 
is the object A itself. 

So, when we define operator++() for MyClass, the final statement of that 
method would be return *this;. 

Likewise, when we define an assignment operator, the return value of that operator 
should be the new value of the left-hand argument. Ending with return «this; 
accomplishes this task. 


C.5.7. Friends 


Private data elements of a class can be accessed by class methods, but not by other 
procedures. However, it is possible to grant a procedure special access to private data 
elements by declaring that procedure to be a friend of the class. 

To do this, we need to declare the friend procedure inside the class declaration 
like this: 


class MyClass { 
private: 


public: 


friend int buddy (MyClass Z); 
}; 


In the .cc file we would see this: 
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int buddy() { 
// calculations using Z2’s fields 
return answer; 


} 


Note that buddy is not a method of MyClass, so in the .cc file we do not use the 
prefix MyClass::. 

It is generally safer not to allow any functions to have access to the data elements 
of aclass. The use of friend procedures subverts the goal of data hiding. In other 
words: Don’t use this feature of C++. 

Furthermore, it is possible to have a procedure that is a friend of two different 
classes, or for one class to be a friend of another. These advanced topics are beyond 
the scope of this text. 


C.5.8 Class templates 


C++ implements complex numbers using a class template. For complex numbers 
with double real and imaginary parts, we use the declaration complex<double> 
whereas for Gaussian integers we use complex<int>. 

We create our own class templates like this: 
template <class T> 
class MyClass { 


private: 
T x; // data element of type T 


public: 
}; 


Here, the T acts as a “type variable.” Now we can declare objects to be of type 
MyClass<int> or even MyClass< complex<double> >. (Note the extra space; 
we need to avoid typing << or >>.) 

Templates must be placed in their entirety in the .h file and all their methods 
defined inline. 

It is possible to define a template with more than one argument, like this: 
template <class U, class V> 
class MyClass { 
private: 

U x; 

V yi 


}; 


C.5.9 Inheritance 


A key feature of object-oriented programming is the ability to add features to 
an existing class to make a new class. For example, we may have a class Graph 
to represent simple graphs (no loops or multiple edges). In some cases, we may 
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wish to consider graphs embedded in the plane (with adjacent vertices joined by line 
segments), which would be an object of type EmbeddedGraph. 

Because there are many instances in which we work with abstract graphs (without 
embedding) we first create the Graph class. Once this is in place, we build the 
EmbeddedGraph class. Rather than start from scratch, we extend the Graph class 
like this: 





class EmbeddedGraph : public Graph { 

private: 

// additional data members to hold the x,y coordinates 
// of the vertices 

public: 





}; 


It is useful for the constructors for EmbeddedGraph to use the constructors of 
Graph as first step. For example, suppose we have a constructor Graph (int n) 
that creates a graph with n vertices. We would want EmbeddedGraph (int n) to 
create the graph, but also set up a default embedding. To do this, we declare the new 
constructor like this: 








class EmbeddedGraph: public Graph { 


public: 
EmbeddedGraph(int n) : Graph(n) { 
// set up the embedding 
} 
}; 


Data in Graph that are declared in the private section are not available to the 
added methods of EmbeddedGraph. If we want to grant access to EmbeddedGraph 
to these data elements, we move them from private to protected. 








class Graph { 
private: 
// data and methods that EmbeddedGraph never needs to access 
protected: 
// data and methods that EmbeddedGraph may access 
public: 
// public methods, accessible to all parts of the program 
}; 





C.6 Standard functions 
C.6.1 Mathematical functions 


The following mathematical functions are available in C++. Many of these are 
declared in the header cmath and you may need a #include <cmath> declaration 
to use them. 
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e abs: absolute value of an int. The absolute value function comes in the 
following flavors. 


- int abs(int x) 


long labs(long x) 
- long long llabs(long long x) 
- double fabs(double x) 


float fabsf(float x) 
- long double fabsl(long double x) 


Of these, abs and fabs are the forms most commonly used. 


@ acos: arc cosine. Usage: double acos(double x). Of course, this re- 
quires -—l<x<l. 


e asin: arc sine. Usage: double asin(double x). Of course, this requires 
-l<x<l. 
e atanand atan2: arc tangent. 


The first is double atan(double x) and gives the arc tangent of x in the 
interval (—2/2,7/2). 


The second is double atan(double x, double y) and gives the angle 
of the vector from the origin to the point (x,y); the result is between —7 and 
T. 


e Bessel functions. The following are available. 


— double j0(double x): first kind, order 0. 

— double j1(double x): first kind, order 1. 

-— double jn(int n, double x): first kind, order n. 
-— double yO (double x): second kind, order 0. 


-— double yl (double x): second kind, order 1. 











-— double yn(int n, double x): second kind, order n. 


There are also the variants j0f through ynf that replace double with float 
as well as 301 through yni that use long doubles. 


e cbrt: cube root. Usage: double cbrt (double x). Returns ¥/x. Might not 
be available on all systems. 


e ceil: ceiling function. Usage: double ceil (double x). This returns [x]. 


There are also the following variants. 


- float ceilf (float x) 
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- long double ceill(long double x) 
cos: cosine. Usage: double cos(double x). Gives cosx. 
cosh: hyperbolic cosine. Usage: double cosh(double x). Gives coshx. 


erf: error function. Usage: double erf (double x). Gives 


fa is -? at 
erx = — e 7 
Ja Jo 


There is the related function double erfc(double x) that gives 1 —erfx. 


exp: e*. Usage: double exp(double x). 
There is a related function double expm1 (double x) that returns e* —1. 


See also pow. 


floor: floor function. Usage: double floor(double x). This returns 
[x]. 
There are also the following variants. 

- float floorf(float x) 

- long double floorl(long double x) 


fmod: mod for reals. Usage: double fmod(double x, double y). This 
returns x — ny where n = |x/y]. 


Gamma function. The function gamma is implemented differently on different 
computers. In some cases it gives (x) but in others it gives logI'(x). 


The related gammaf and gammal work with float and long double values, 
respectively. 


Free of ambiguity, 1gamma gives logI'(x) and tgamma gives I(x). 
Some systems have additional variations of 1gamma. On a UNIX system, type 


man gamma orman lgamma for more information. 


hypot: hypotenuse. Usage: double hypot (double x, double y). Re- 
turns \/x2 + y?. 


log: natural logarithm. Usage: double log(double x). Returns log, x. 
The related double loglp(double x) that returns log(x+ 1). 
Also double 1log10 (double x) returns log))x. 


pow: exponentiation. Usage: double pow(double x, double y). Re- 
turns x”. See also exp. 


sin: sine. Usage: double sin(double x). Returns sinx. 
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e@ sinh: hyperbolic sine. Usage: double sinh(double x). Returns sinhx. 
e sqrt: square root. Usage: double sqrt (double x). Returns \/x. 
e tan: tangent. Usage: double tan(double x). Returns tanx. 


e tanh: hyperbolic tangent. Usage: double tanh(double x). Returns tanhx. 


C.6.2 Mathematical constants 


Various constants are defined? via the <cmath> header. Here is a list. M_PI 







































C++ name 
| LOG2E log, e 
| LOG10E logigé 
| LN2 In2 
| LN10 In 10 
[PI 1 
| PI_2 m/2 
| PI_4 m/4 
1 Pr 1/a 
2 PI 2/% 
[_2_SORTPI | 2/./a 
| SQRT2 v2 
_sortT1_2 | 1/72 





C.6.3. Character procedures 


The following procedures require #include <cctype> and provide convenient 
tools for manipulating characters. Many of these are defined in terms of the int type 
and not the char type. This is not an issue with a function such as islower. This 
procedure checks if its argument represents a lowercase letter (from a to z). It would 
be logical to expect that the argument to islower is a char and its return value is a 
bool. However, both values are type int. This is inconsequential for this particular 
function because code such as this works as expected: 


char ch; 
if (islower(ch)) { 


} 


2Not all compilers define these constants. If your compiler does not, you can define them yourself in 
a header file named, say, myconstants.h. Use statements such as this: const double MPI = 
Se LATO oaks 
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Problems arise when using a procedure such as tolower that converts uppercase 
characters A to Z to their lowercase form. It would be logical to expect this proce- 
dure’s argument and return types to be char, but this is not the case. Instead, both 
are type int. The consequence is that the statement cout<<tolower (’G’) ; does 
not print the character g on the screen. Instead, it prints the value 103. Why? 

When the procedure tolower (’G’) is encountered the char value ’G’ is auto- 
matically converted into an int value (because that’s what tolower expects). Ef- 
fectively, this becomes tolower (71) (because G is represented inside the computer 
as the number 71). Now tolower does its work and converts the code 71 for G to 
the code for g and returns that value: 103. That is the value that is sent (via the << 
operator) to cout. 

The issue becomes: how do we convert the value 103 to the desired character g? 
Simply wrap char around the return value from tolower. The successful way to 
convert G to g is to use this: char (tolower(’G’)). 

One additional warning: Do not use tolower ("G"). The "G" is a character array 
(type char~) and not a single character (type char). The C++ compiler is able to 
convert a char to an int, so such a statement might generate only a warning from 
the compiler. When run, this code would act on the memory address of the character 
array, and not on the character G as you intended. 


Here are the procedures. All of them require #include <cctype>. 


e isalnum(ch): checks if ch is either a letter (upper- or lowercase) or a digit 
(0 through 9). 


@ isalpha (ch): checks if ch is a letter (upper- or lowercase). 


@ isdigit (ch): checks if ch is a digit (0 through 9). 





@ isgraph (ch): checks if ch is a printable character (such as letters, digits, 
or punctuation) but not white space (such as a space character, a tab, or a 
newline). 


e islower (ch): checks if ch is a lowercase letter (a to z). 


® isprint (ch): checks if ch is a printable character (including letters, dig- 
its, punctuation, and space). A nonprintable character is known as a control 
character. Those can be detected with iscntrl. 


@ ispunct (ch): checks if ch is a punctuation character. 


e@ isspace (ch): checks if ch is a white space character (such as a space, tab, 
or newline). 


@ isupper (ch): checks if ch is an uppercase letter (A to Z). 


@ isxdigit (ch): checks if ch is a digit from a hexadecimal number (i.e., one 
of 0 through 9, a through f, or A through F). 
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@ tolower (ch): converts ch to a lowercase letter (if ch is an uppercase letter). 
Otherwise, this returns the value ch unchanged. 


In most cases, use char (lower (ch) ). 


@ toupper (ch): converts ch to an uppercase letter (if ch is a lowercase letter). 
Otherwise, this returns the value ch unchanged. 


In most cases, use char (toupper (ch) ). 


C.6.4 Other useful functions 


The header <cstdlib> contains other functions useful for C++ programming. 
Here we list the ones most useful for mathematical work. (The inclusion of the 
header <cstdlib> might not be required on your system.) 


@ abort: quickly halt the execution of the program. The syntax is abort (). 
This is an “emergency stop” procedure that brings a program to a screeching 
halt. A message, such as Abort trap is written to the screen. 


There are better ways to stop your program. If possible, arrange your code 
so the program always manages to find its way to the end of the main () 
procedure (or to a return statement in the main). Alternatively, use exit 
(described below). 


@ atof, atoi, atol: convert character arrays to numbers. The syntax for these 
are: 


- float atof(charx str) 
- int atoi(char« str) 


- long atol(charx str) 


In all cases, str is a character array (not a C++ string) and the procedure 
converts the character array into a number. For example, atoi ("23") returns 
an int value equal to 23. 


Some platforms support an atol1 procedure that converts its character array 
toalong long. 


e® exit: terminate the program. Usage: exit (int x). The preferred method 
for ending a program is for the execution to reach a return statement in the 
main. Sometimes, this is not practical. In such cases, it is convenient to call 
exit to end the program. 


The argument to exit is sent as a “return code” back to the operating system. 
(The return value in main serves the same purpose.) By convention, use a 
return value of 0 if all is well and a nonzero value if something amiss occurred 
(e.g., your program was unable to open a file it needed). 
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e rand: return pseudo random values. Usage: int rand(). This returns a 
“random” integer value between 0 and RAND_MAx (inclusive). See Chapter 4. 


e srand: initialize the random number generator. Usage: void seed(int x). 
This resets the pseudo random number generator to a given starting position. 
A good choice for a seed value is the system time. To do this, use the statement 
srand (time (0) ); (you may need to include the ct ime header). 


Appendix D 


Answers 


This appendix provides answers and useful comments for nearly all of the exercises 
in this book. 


1.1 


12 


1.3 


1.4 


1.35 


2.1 


2.2, 


The first »/ after the word and ends the comment. The additional «/ on the 
last line causes the error. 


The first message complains that the cout object is deemed undeclared despite 
the fact that the programmer did not forget #include <iostream>. What 
the programmer did forget is the statement using namespace std; without 
which cout is not understood. 


The second error caused a parse error on line 5. However, there is noth- 
ing wrong with line 5. The error is on line 4 where we forgot to include the 
semicolon. However, the compiler did not get confused by this omission until 
it reached line 5. 


No. If // or /* appear inside quotation marks, they are part of the character 
sequence and are not interpreted as the start of a comment. 


The sequence \n starts a new line. The statements cout << "\n"; and 
cout << endl; have the same effect. 


The sequence \t causes the output to skip to the next tab stop in the output. It 
is useful for lining up data in columns. 


The sequence \\ causes a single backslash \ to be written. 


Don’t make such a fuss fuss 
This is more fun than learning C++! 


The number 3 is printed to the screen. When the float 3.5 is assigned to an 
int variable, there is a loss of precision; the int variable holds just the value 
3. Then, when the int value e is assigned to the double variable, the double 
is given the value 3. 


A good compiler should warn that assigning a float from an int can result 
in loss of precision. 


The output from the program looks like this: 


415 


416 
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10 
12 
13 


10 
13.3333 





Only cout << (4./3)+*10 gives the proper output. 


The output of the program looks like this: 





2.4 


2.5 


2.6 


2.7 
2.8 


The mathematician’s mod operation a mod n is usually only defined for n > 0 
and a mod n is an element of {0,1,2,...,2—1}. Thus, —5 mod 3 = 1, but 
C++ returns —2 for (-5)%3. In addition, C++ allows the modulus, n, to be 
negative. 


Both 3’ and 3 are integer types (the first is a char which is considered to be 
an integer type). The result of this expression is false because the character 
'3" does not have the same value as the integer 3. Indeed, on many comput- 
ers ‘3’ has the value 51 because the character ‘3’ is the 51st in the ASCII 
character set. 


The first occurrence of the expression a==b evaluates to false because, when 
this expression is reached, a and b hold different values. When a bool value 
of false is written to the screen, the number 0 is used. 


Next, the expression a=b has the effect of copying b’s value into a and returns 
the value now held in common in a and b. Hence, 10 is printed. 


Finally, when the second occurrence of a==b is evaluated, both a and b hold 
the value 10 and so the expression evaluates to true which is printed as 1 on 
the screen. 


The result of your experiment might depend on the computer on which it is 
run. The following is the typical result. 


If the numerator and denominator are both int types, both 8 and 4 evaluate 
to zero. 


However, if the numerator or the denominator (or both) are float then the 
special values nan and inf are returned for 8 and +, respectively. Clearly 
inf stands for infinity whereas nan stands for not a number. 
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(a) A variable name may not begin with a digit. 


(b) The minus sign is an operator and may not be part of a variable’s name. 


3.1 


32 


3.3 


3.4 
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(c) The word double is a C++ keyword and may not be used as a variable 
name. 


(d) A variable name may not include a colon. 
(e) The ampersand is an operator and may not be part of a variable’s name. 


(f) This begins with a digit, contains a minus sign, and is a number (equal 
to 0.01). 


d =17,x =6, and y = —1. Other answers for x and y are possible. 


If this procedure is invoked with n equal to —1 we fall into an infinite recur- 
sion. 


There is also the issue that if a large value of n is passed to this procedure, 
the result would be too large to fit in a long, overflow would result, and the 
answer returned would be incorrect. 


In this implementation, we take the input argument to be a real number (type 
doub1e) and the return value to be an int. Your choice may vary. 


int signum(double x) { 
if (x < 0.) return -1; 
if (x > 0.) return 1; 
return 0; 


} 


Here is an iterative version. 


long fibonacci(long n) { 
if (n < 0) return -1; 
if (n==0) return 1; 
if (n==1) return 1; 


long a = 1; 
long b = 1; 
long c; 


for(int k=2; k<=n; k++) { 


c = atb; 
a= b; 
b=c; 

} 

return c; 


This is a recursive version. 


long fibonacci(long n) { 
if (n < 0) return -1; 
if (n==0) return 1; 
if (n==1) return 1; 
return fibonacci(n-1)+fibonacci(n-2); 
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The iterative version is significantly faster than the recursive version. When 
the iterative version computes F,,, it does n — | additions. However, when the 
recursive version computes F;,, it requests the calculation of F,,_; and F,_2. 
The calculation of F,_; also requests the computation of F;,-2, and this is 
wasted effort. The amount of work needed to calculate F;, grows exponentially 
with n. 


When asked to calculate F;,, the recursive procedure presented here is called 
2F, — | times (your program may have different behavior). This is easy to 
show by induction. Let c(m) denote the number of times fibonacci is called 
when asked to calculate F,. For n = 0,1 we have c(n) = 1 and forn > 1 we 
note that c(n) = 1+c(n—1)+c(n—2). Now one checks that 2F;, — | satisfies 
this recurrence with the given initial conditions. 


The values you were requested to find are 


Foo = 10,946 F39 = 1,346,269 F49 = 165,580,141. 


Here is a complete program. 


#include <iostream> 
#include <cmath> 
using namespace std; 


const float zeta2 = M PI*M PI/6.; 


float zeta2up(long n) { 
float ans = 0.; 
for (long k=1; k<=n; k++) { 
ans += 1./float(k)/float(k); 
} 
return ans; 


} 


float zeta2down(long n) { 
float ans = 0.; 
for (long k=n; k>=1; k--) { 
ans += 1./float(k)/float(k); 
} 
return ans; 


} 


int main() { 
long n = 1000000; // 1076 
cout << "zeta2up = " << zeta2up(n) << endl; 
cout << "zeta2down zeta2down(n) << endl; 
cout << "truth = " << zeta2 << endl; 
return 0; 


} 


i] 
A 
A 


The output looks like this. 


zeta2up = 1.64473 
zeta2down 1.64493 


truth = 1.64493 





3.7 


3.8 
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Observe that zeta2down, which begins the sum with 1/N7, gives the more 
accurate result. The discrepancy is due to roundoff issues. A float holds only 
so many digits and (on my computer) the epsilon value for a float is around 
10~7. This means that by the time the sum reaches k = 10°, the value held in 
ans is too large for the addition of 107!” to have any effect. Many terms at the 
end of the series have little or no effect on the sum; their contribution is lost. 
However, those tail terms do have a cumulative contribution on the actual sum 
and are needed to give an accurate result. By summing in the reverse order 
these small terms do not have their contributions lost. 


The important issue here is to use call by reference for the third and fourth 
arguments. Here is a complete program and its output. 


#include <iostream> 
#include <cmath> 
using namespace std; 


void xy2polar(double x, double y, double& r, double& t) { 
r = hypot(x,y); 
t = atan2(x,y); 

} 


void polar2xy(double r, double t, double& x, double &y) { 
xX = rxcos(t); 
y = resin(t); 


} 


int main() { 
double x,y,r,t; 


x = -4.; y = -1.; 
xy2polar(x,y,r,t); 


cout << "The point (" << x << "," << y 
<< ") in polar coordinates is (" 
<< xr << "," << t << ")" << endl; 


r=2.; t = 2.5; 
polar2xy(r,t,x,y); 
cout << "The point in polar coordinates (" << r 
<< "," << t << ") is (" << x << "," << y << ")" << endl; 


return 0; 


The point (-4,-1) in polar coordinates is (4.12311,-1.81577) 


The point in polar coordinates (2,2.5) is (-1.60229,1.19694) 





Here is a program. Change long to long long (or _-int64) if that type is 
available to you. 


#include <iostream> 
using namespace std; 
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bool is_zero_one(long n) { 
long ones_digit = n 2% 10; 
if (ones_digit > 1) return false; 
if (n == 0) return true; 
return is_zero_one(n/10); 


} 


long find_zero_one mult(long n) { 
for (long k=1; ; k++) { 
long m = kxn; 
if (m < 0) return -1; // overflow without success 
if (is_zero_one(m)) return m; 


} 


return 0; 


} 


int main() { 
for(long k=1; k<=100; k++) { 
cout << k << "\t" << find_zero_one mult(k) << endl; 


} 


return 0; 


} 


The first procedure, is_zero_one, checks if its input argument consists en- 
tirely of Os and Is (in base ten) by a recursive algorithm. The second proce- 
dure, find_zero_one_mult, does its work by trying all positive multiples 
of the input argument until it succeeds. However, if the multiplies overflow 
(detected by testing if (m<0)) then we return —1 to signal failure. 


Changing long to long long avoids the overflow problem, but then it takes 
much longer to find the proper multiple. 


This program is not efficient. You may notice the computer pausing while it 
works to find the least multiple of 9 of the required form: 111111111. The 
program is not likely to find the least such multiple of 99, because it is 


TLLLLLL11111111111. 
—_ SS eee 


18 digits 


Instead of testing successive multiples of n until we find the result we want, we 
can step through decimal numbers composed entirely of Os and 1s and check 
if n is a divisor. However, this is trickier to program. 


To step through the decimal values 1, 10, 11, 100, 101, 110, and so on, we re- 
alize that if we interpret these numbers as binary, then we are simply counting 
1, 2,3, 4,5, and so on. If we had a procedure to convert binary numbers to the 
corresponding decimal number with the same digits, the task would be easy. 


To this end, we create a procedure named bin2dec that performs the mapping 


n= ¥ bj! f(n) = ¥ bj10/ 
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where the b; are in {0,1}. There’s a nice recursive way to define this transfor- 
mation: 
10f (3) if n is even, and 


PO) =) log (15) +1 if nis odd 


with base cases f(0) =0 and f(1) = 1. [Note: The recursion can be written 
with a single algebraic expression like this: f(m) = 10f(|n/2]|) + (n mod 2).] 


With this idea in place, we present a second solution to this problem. This 
program runs much faster than the first. 


#include <iostream> 
using namespace std; 


long long bin2dec(long n) { 

if (n==0) return 0; 

if (n==1) return 1; 

return 10*bin2dec(n/2) + (n%2); 
} 


long long find_zero_one_mult(long long n) { 
for (long long k=1; ; k++) { 
long long m = bin2dec(k); 
if (m < 0) return -1; // overflow without success 
if (m@n == 0) return m; 
} 


return 0; 


} 


int main() { 
for(long long k=1; k<=100; k++) { 
cout << k << "\t" << find_zero_one mult(k) << endl; 


} 


return 0; 


Here is a program that does the job. 


#include "uniform.h" 
#include <iostream> 
#include <cmath> 

using namespace std; 


int main() { 
double x,y,u,v; 
const long nreps = 100000000; 
double sum; 
seed(); 
sum = 0; 


for (long k=0; k<nreps; k++) { 
7 
7 


sum += sqrt( (x-u)*(x-u) + (y-v)*(y-v) ); 
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} 

cout << "The average length of the segment is " << sum/nreps 
<< endl; 

return 0; 


This gives the following output. 


The average length of the segment is 0.521435 


This naturally leads to the question: What is the analytic answer? My col- 
league James Fill informs me that it is * (2 + J2+ sinh”! 1) which is ap- 
proximately 0.521405. 


4.2 Here is a program. Note the inclusion of the uniform.h header; to compile 
this program we need this file (call it buffon.cc) and the files uniform.h 
and uniform.cc. 


#include <iostream> 
#include <cmath> 

#include "“uniform.h" 
using namespace std; 


/ xx 
* This procedure simulates one drop of Buffon’s needle. 
* It returns true if the needle crosses a line and false if not. 


«/ 

bool drop() { 
double x1; // x-coord of one end point of the needle 
double x2; // x-coord of the other end point 


double theta; // orientation of the needle 


xl = unif(); 
theta = 2«M PIxunif(); 
x2 = x1 + cos(theta); 


if (floor(xl) == floor(x2)) return false; 


return true; 


} 


int main() { 
long nreps; // number of times to drop the needle 


cout << "Enter number of needle drops -> "; 
cin >> nreps; 


seed(); 
long count = 0; // number of successful drops 
for (int k=0; k<nreps; k++) { 

if (drop()) ++count; 


} 
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cout << count << " successes out of " << nreps 
<< " drops" << endl; 
cout << "frequency = " << double(count)/double(nreps) << endl; 


} 


Here is a sample run of this program. 


Enter number of needle drops -> 100000000 
63653758 successes out of 100000000 drops 


frequency = 0.636538 





This is reasonably close to the theoretical value, 2 = 0.63662. 


Here is some advice on how to approach this exercise. The procedures to gen- 
erate points are random in a circle and in a triangle should be of the following 
form, 


void point_in_circle(double& x, double& y); 
void point_in_triangle(double& x, double& y); 


Using reference arguments enables these procedures effectively to return two 
values. 


For point_in circle, use a rejection algorithm. That is, generate a point 
(x,y) uniformly at random in the square [—1,1] x [—1,1]. If x7 + y? <1, then 
return (x,y); if not, try again. This is a good opportunity to use the do-while 
control structure. 


For point_in_ triangle, it does not matter in which triangle the points are 
generated. (Reason: Whether four points lie at the vertices of a convex quadri- 
lateral is invariant under invertible affine transformations.) For simplicity, use 
the triangle with vertices located at (0,0), (1,0), and (0,1). A rejection al- 
gorithm may be used (generate points in a square until finding one in the tri- 
angle). However, it is more efficient to find a point uniformly at random in 
(0, 1] x [0,1] and if it lies in the wrong half of the square, reflect it across the 
line through (0,1) and (1,0). 


To test if four points determine the corners of a convex quadrilateral, first write 
a procedure to see if the points (x;,y;) and (x2,y2) lie on opposite sides of 
the line through (x3,y3) and (x4,y4). They are if and only if the two triples 
of points (1,1), (x2,¥2),(%3,y3) and (x1,91),(%2,y2),(x4,y4) have opposite 
orientation (see the figure). 
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Thus, the points (x;,y;) and (x2,y2) lie on opposite sides of the line through 
(x3,y3) and (x4,y4) if and only if 


Ixy Ixy 
det 1 x2 y2|- 1 x2 y2 <0. 
1 x3 y3 1x4 y4 


Call this procedure something like opposite sides and use it to build a 
procedure that tests if four points determine a convex quadrilateral. 


Your experiments should yield the following results. For a triangle, P(K) = ;. 
For a circle, P(K) = 1 — 25 ~ 0.70448. 


Despite the presence of trig functions, the first version is somewhat faster than 
the rejection method on my computer. 


The probability that a point (x,y,z) chosen uniformly at random in [—1,1] 
lies within distance one of the origin equals the volume of the ball of radius 1 
divided by the volume of the cube: im +8= 1/6 0.5236. 


In high-dimensional space, the unit ball occupies only a tiny fraction of the 
cube [—1, 1]”. Therefore, the probability that a given iteration of the rejection 
algorithm succeeds is small and many iterations are required to generate a 
point within the unit ball. 


An efficient way to generate a point x = (x1,x2,...,%,) uniformly at random 
on the unit sphere in R” is to assign to each x; a Gaussian (0,1) random value 
and then to scale by 1/|{x'. 


In order for the procedure to remember the position of the particle from one 
invocation to the next, use a static variable. Here is the code. 


#include "“uniform.h" 


int random_walk() { 

static int position = 0; 

Lf (unii() > 0.5) < 
++position; 

} 

else { 
--position; 

} 


return position; 


Naturally, we need to use a static variable to remember the value between 
calls. However, a static variable declared in up is not available for use by 
down, or vice versa. (It is possible to use a global variable, defined outside the 
scope of any procedure, but this practice is frowned upon.) The solution is to 
put the static variable in another procedure! Here’s a solution. 
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int updown(int change) { 
static int value = 0; 
value += change; 
return value; 


} 


int up() { 
return updown(1); 


} 


int down() { 
return updown(-1); 


} 


(100) = 4, (2°) = 256, and (6!) = 192. 


The problem is with the declaration int vals[n];. Because the value of n 
cannot be determined when the program is compiled, this statement is illegal. 
Instead, declare vals with the statement int« vals; and then allocate space 
with vals = new int[n];. When vals is no longer needed, release the 
allocated memory with delete[] vals;. 


x = 23 (mod 180). 


First, there is nothing wrong with using bool types for the array theSieve. 
The decision to use char is based on an oddity. Most compilers use one byte 
to house a char, but some use four bytes to house a bool. Use the expressions 
sizeof(char) and sizeof(bool1) to learn the behavior on your computer. 


If we are using an array that has only a million entries, then the difference 
between one and four bytes per cell is not important. But if the array has 
hundreds of millions (or a billion) entries, then the difference is important as 
the program may exhaust available memory. 


In Chapter 8 we introduce the vector<boo1> type that provides greater mem- 
ory efficiency; this uses only one bit for each entry. 


Did you remember to declare your array to hold 21 values? 


#include <iostream> 
using namespace std; 


int main() { 
long fib[21]; 
fib[0] = 1; 
fib[1] 1; 
for(int k=2; k<=20; k++) { 
fib[k] = fib[k-1] + fib[k-2]; 
} 
for (int k=0; k<=20; k++) { 
cout << k << "\t" << fib[k] << endl; 
} 


return 0; 
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5.7 Here is a program. 


#include <iostream> 
using namespace std; 


int main() { 
const int STEPS = 15; 
long a[STEPS]; 
long b[STEPS]; 


a[0] = b[0] = 1; 


for (int k=1; k<STEPS; k++) { 
a[k] = b[k-1]; 
b[k] = a[k-1] + 2«b[k-1]; 

} 


for (int k=0; k<STEPS; k++) { 
cout << k << "\t" << a[k] << "\t" << b[k] << "\t" 
<< double(a[k])/double(b[k]) << endl; 
} 
return 0; 


} 


Notice the use of a const int to declare the array sizes. If we decide to 
recompile this program to generate arrays of a different size, then we only 
need to edit this one value. 


Here is the output of the program. 


- 333333 

-428571 

17 -411765 
41 -414634 
99 -414141 
239 -414226 
577 -414211 
1393 -414214 
3363 -414213 
8119 -414214 
19601 -414214 
47321 -414214 
114243 -414214 
114243 275807 -414214 


0 
1 
2 
3 
4 
5 
6 
7 
8 


Ke} 
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BwWNRO 





Based on this chart, it is safe to conjecture that a,/b, J2—1. 


Here’s one approach to proving this. The recurrence can be written in matrix 


form a eh) oa allie 


The eigenvalues of fF al are 1 +1/2 with corresponding eigenvectors Beall ; 








respectively. The iterates of this linear system diverge in the direction of the 
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eigenvector corresponding to the eigenvalue of largest magnitude, 1 + V2; that 
is, they tend to infinity in the direction [1492] , and so ay,/by > —1+ V2. 


Here is such a procedure. 


long max_value(const longs array, long nels) { 
long ans; 


ans = array[0]; 


for (long k=1; k<nels; k++) { 
if (ans < array[k]) { 
ans = array[k]; 
} 
} 


return ans; 


} 


Notice that the first argument is type const longs. The longs means that 
the argument is an array of long values. The const certifies that this proce- 
dure does not modify the values held in the array. 


Here is a procedure to generate an array of Fibonacci numbers as a return 
value. 
longx make_fibs(long n) { 

longs ans; 

ans = new long[n]; 

ans[0] = 1; 

ans[1] = 1; 

for (int k=2; k<n; k++) ans[k] = ans[k-1] + ans[k-2]; 

return ans; 


} 


Notice that the return type is long» because this procedure returns an array. 


The problem with the main() given in the problem is that it suffers a memory 
leak. The array created by make_fibs is never released with a delete, ] 
statement. 


The use of new in this design is unavoidable. A better strategy is to design 
a procedure with type void make_fibs(long n, longs array);. It is 
then the responsibility of the programmer to allocate an array of the appropri- 
ate size before invoking this procedure: 

longs fibs; 

fibs = new long[20]; 

make_fibs(20,fibs); 

Ef eee 

delete[] fibs; 


alternatively: 


long fibs[20]; 
make_fibs(20,fibs); 
//loee 
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No delete, ] is necessary in this second instance because fibs was not allo- 
cated with new. 


Here is such a procedure. 


long fibs(int n) { 
const int MAX ARG = 40; 
static bool first_time = true; 
static long values[MAX ARG+1]; 


if (first_time) { 
values[0] = 1; 
values[1] = 1; 
for (int k=2; 


=2; k<=MAX_ARG; k++) { 
values[k] 


values[k-1] + values[k-2]; 
} 


first_time = false; 


} 


if ((n<0) || (m>MAX_ARG)) return -1; 
return values[n]; 


The key idea is the use of static variables. The Boolean first_time is 
initialized to true so the code can detect when it is first run. The array values 
is then populated with Fibonacci numbers and first_time is set to false 
so the initialization is not repeated on subsequent calls. The array values is 
also declared to be static so that its contents persist between invocations. 


Here is such a program. 


#include <iostream> 
using namespace std; 


int main() { 
long size = 10000000; // ten million 
longs array; 
long count = 0; 
while (true) { 
array = new long[size]; 
++count; 
cout << "Success with array #" << count << endl; 


} 


When this program is run on my computer, we see the following output. 


Success with array #1 
Success with array #2 


Success with array #3 
Success with array #4 





Success with array #90 
Success with array #91 
xxx malloc: vm_allocate(size=40001536) failed (error code=3) 
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«xx Malloc[4998]: error: Can’t allocate region 
Abort trap 


5.12 Enter the digits (separated by spaces) into the On-Line Encyclopedia of Integer 
Sequences. It responds that this is sequence A059742 giving the decimal digits 
of m+e. 


6.1 Here is a header file for the Line class. 


#ifndef LINE_H 
#define LINE_H 


#include "Point.h" 


class Line { 
private: 
double a,b,c; // to specify the line ax+by+c=0 


public: 
// constructors 
Line(); 
Line(Point P, Point Q); 
Line(double aa, double bb, double cc); 


// get methods 

double getA() const; 
double getB() const; 
double getC() const; 


// reflection methods 
void reflectxX(); 
void reflectY(); 


// check if a Point is on this Line 
bool incident(Point P) const; 


// generate a Point on this Line 
Point find _Point() const; 


// check if this Line equals another 
bool operator==(const Line& that) const; 


he 


// write a Line to an output stream 
ostream& operator<<(ostream& os, const Line& L); 


// find the distance between a Point and a Line 
double dist(Line L, Point P); 

double dist(Point P, Line L); 

#endif 

And here is the code file Line.cc. 


#include "Line.h" 
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Line::Line() { 
a=b=ce=0.; 


} 


Line::Line(Point P, Point Q) { 
// get the coordinates of the points 
double xl = P.getX(); 
double yl = P.getY(); 
double x2 = Q.getX(); 
double y2 = Q.getY(); 


// If the points are the same, make the Line horizontal 
// through the one point. 


if (P==Q) { 
cerr << "Warning: Constructing Line from two equal Points" 
<< endl; 
a= 0.; 
b= 1.; 
c = -yl; 
return; 
} 


// If the points are distinct, we continue starting 
// with the special case of a vertical line 
if (xl == x2) { 


a=1.; 
b= 0.3 
c = -xl; 
return; 


// The points are distinct and not vertical 
a= y2 - yl; 
b xl - x2; 
c = x2«*yl - xlxy2; 
} 


Line::Line(double aa, double bb, double cc) { 

// Check if the data are valid 

if ((aa==0.) && (bb==0.)) { 
cerr << "Warning: Invalid call to Line(aa,bb,cc)" << endl; 
a= 0.; 
b= 1.; 
c = cc; 
return; 


= aa; 
bb; 
= cc; 


(oR OME Mita ad 
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} 


// get methods 


double Line::getA() const { return a; } 
double Line::getB() const { return b; } 
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double Line::getC() const { return c; } 


// veflection methods 
void Line::reflectx() { b = -b; } 


void Line::reflectY() {a 


// check if a Point is on 
bool Line: :incident(Point 
return axP.getX() + bxP. 


} 


// generate a Point on a Line 


-a; } 


this Line 
P) const { 
getY() +c == 0. ; 


Point Line::find_Point() const { 
// if it’s a vertical line, return x-intercept 
if (b==0.) { 

return Point(-c/a, 0); 


} 


// otherwise, return the x-intercept 
return Point(0,-c/b); 


} 
bool Line: :operator==(const Line& that) const { 
// Special case when a == 0 
if (a==0) { 
if (that.a != 0) return false; 
return c/b == that.c/that.b; 
} 
// When a is not 0 
if (that.a == 0) return false; 
return (b/a == that.b/that.a) && (c/a == that.c/that.a); 


} 


// for writing to an output stream 

ostream& operator<<(ostream& os, const Line& L) { 
os << "[" << L.getA() << ", 

<< L.getC() << "]"; 

return os; 


} 


" << L.getB() << "," 


// determine the distance from a Point to a Line 
double dist(Line L, Point P) { 


// fetch a,b,c for the line 
double a 
double b 
double c 


// fetch 
double x 
double y 


the 


L.getA(); 
L.getB(); 
L.getC(); 
P.getxX(); 
P.getY(); 


coordinates of the point 


// normalize by dividing by sqrt(axatbxb) 


double d 
a /=d; 
b /= d; 
c /=d; 


sqrt(axa + bxb); 
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// project P onto the unit vector (a,b) and add c 
double ans = xxa + yxb + c; 


return fabs(ans); 


} 


double dist(Point P, Line L) { return dist(L,P); } 


It is natural to suspect that something is wrong with the logic and algebra used 
to create the procedures, but that is not the case. If we examine the [a,b,c] 
triples for the two lines, we see that the triple for L is a scalar multiple of the 
triple for M (the factor is 1.4), so these represent the same line. 


The problem is roundoff. Indeed, if we print the distance from Y to M the 
computer responds 8.88178e-16. Minute errors in the divisions cause the 
problems; note that the slope of the line is —5/7 and the quotient cannot be 
held exactly in a double variable. 


There is no perfect solution to this problem. A good strategy is to replace exact 
equality tests with |x —y| < € where ¢ is either built into the code or is set by 
the user. 


The modification to Line.h is modest. The old private section would be 
replaced by this: 
private: 


Point A; 
Point B; 


Nothing else in Line.h would need to be modified. 


Extensive repairs to Line.cc are now needed. For example, the get methods 
would need to be completely reworked. 


However, code that uses the Line class would not require any modification at 
all! 


A good way to do this is with a procedure declared like this: 


bool intersect(Line L, Line M, Point& P); 


The input Line objects are L and M. If they are parallel, then the procedure 
should return false (to mean do not intersect) and leave P unaffected. Other- 
wise, we set P to be the Point of intersection and return true. 


It is not unreasonable to make the end points of a LineSegment object be 
public data elements because if a program modifies these data directly (and 
not through a set method), there is no possibility of creating an invalid object 
(we allow the two end points to be the same). By contrast, were we to allow 
open access to a Line object’s data, an unwary user might set both a and b to 
0 creating an invalid Line object. 
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In general, it is better to keep the data hidden and write simple get and set 
methods to manipulate those data. 


Here is a header file LineSegment.h. Writing the LineSegment.cc file is 
left to you. 


#ifndef LINE SEGMENT _H 
#define LINE SEGMENT H 


#include <iostream> 
#include "Point.h" 
using namespace std; 


class LineSegment { 

private: 
// the end points of the segment 
Point A; 
Point B; 


public: 
// constructors 
LineSegment(); 
LineSegment(Point P, Point Q); 
LineSegment(double x1, double yl, double x2, double y2); 


// get & set methods 
Point getA() const; 
Point getB() const; 
void setA(Point P); 
void setB(Point Q); 


// Length and midpoint methods 
double length() const; 
Point midpoint() const; 


// Check for equality 
bool operator==(const Point& that); 


he 


// for output 
ostream& operator<<(ostream& os, const LineSegment& LS); 


#endif 


Here are two solutions. In both cases, updating the fields x and y is straight- 
forward. The key issue is: how do we write the return statement at the end 
of the procedure. 


In this first solution, we make a copy of the Point and return that: 


Point Point::translate(double dx, double dy) { 
x += dx; 
y += dy; 
return Point(x,y); 


} 
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This code is clear but suffers a minor inefficiency because it makes a copy of 
the Point and then that copy gets sent back as a return value. We can make 
this more efficient by returning the Point object itself. Here is how that is 
done. 
Point Point::translate(double dx, double dy) { 

x += dx; 


y += dy; 
return «this; 


} 


The object «this is the Point object itself, so no extra copy is needed. 


In this simple example, the inefficiency is minimal. However, if this method 
were to be used extensively then the change from return Point(x,y); to 
return «this; can make a noticeable difference. 


This is a subtle problem. Suppose we define a procedure proc with one argu- 
ment. There are two ways we can declare this procedure: 


Point proc(Point Q); 
Point proc(Point &Q); 


If we use the first syntax, then a copy of the argument is sent to the procedure, 
but if we use the second syntax, then the argument itself is sent. That is, when 
we call proc(W) the first version cannot modify w, but the second version can. 


Similarly, the normal behavior of return X is to send back a copy of x. How- 
ever, if we want to return the object x itself, we need to add an & to the return 
type in the procedure declaration. 


For the problem at hand, we need to change the return type of the translate 
method from Point to Pointé. Inthe public section in Point.h we declare 
the procedure like this. 


Point& translate(double dx, double dy); 


In Point.cc we have the following code. 


Point& Point::translate(double dx,double dy) { 
x += dx; 
y += dy; 
return «this; 


} 


Let’s examine how the old versions (from the previous problem) and this new 
version behave for the code (P.translate(1,2)).translate(10,10);. 


In either old version P.translate(1,2) returns a copy of P. (The first old 
version returns a copy of acopy of P!) So the second invocation of translate 
acts on a copy of P and not the object P itself. Therefore, P is not modified by 
translate(10,10). 
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However, in the new version, the statement return «this; returns the object 
itself and not a copy. Therefore the second translate(10,10) acts on P and 
not on some unnamed copy of P. 


One last point: In the solution to Exercise 6.6, both return Point(x,y); 

and return »*this; have the intended effect of returning a copy of the Point. 
In this exercise, the code return Point(x,y); is inappropriate. We do not 
want to return a copy of the Point; we want to return the Point itself. So we 
must use return «xthis;. 


Here is the file Interval.h. Note that the keyword inline is optional for the 
class methods but mandatory for the operator<< procedure. We require both 
#include <iostream> andusing namespace std; to use ostream ob- 


jects. 


#ifndef INTERVAL _H 
#define INTERVAL _H 
#include <iostream> 
using namespace std; 


class Interval { 
private: 
double a,b; // end points of [a,b] 


public: 
Interval() { 
a= 0.; 


Interval(double x, double y) { 
if (x<y) { 
a= x; 


double getA() const { return a; } 
double getB() const { return b; } 


bool operator==(const Interval& that) const { 
return (a==that.a) && (b==that.b); 
} 


bool operator!=(const Interval& that) const { 
return !(*this == that); 


} 


bool operator<(const Interval& that) const { 
if (a < that.a) return true; 
if (a > that.a) return false; 
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return b < that.b; 
} 


he 


inline ostream& operator<<(ostream& os, const Interval& I) { 
os << "[" << I.getA() << "," << I.getB() << "]"; 
return os; 


} 


#endif 


7.2 The following program accomplishes the required task. It does its work by the 
following observation. Suppose the intervals are 1) ,Jo,...,J, where Ij = [a;,bj| 
with aj < b;. Let a = maxj;a; and B = min;b;. Interval J, meets all intervals 
if and only if a, < B andby > a. 


#include "Interval.h" 
#include "uniform.h" 
using namespace std; 


double find_max_A(const Interval« list, long ni) { 
double ans = list[0].getA(); 
for (long k=1; k<ni; k++) { 
if (ans < list[k].getA()) ans = list[k].getA(); 
} 


return ans; 


} 


double find_min_B(const Interval« list, long ni) { 
double ans = list[0].getB(); 
for (long k=1; k<ni; k++) { 
if (ans > list[k].getB()) ans = list[k].getB(); 
} 
return ans; 


} 


bool one_meets_all(const Intervals list, long ni) { 
double alpha = find_max_A(list,ni); 
double beta = find_min B(list,ni); 


for (long k=0; k<ni; k++) { 
if ((list[k].getA() <= beta) && (list[k].getB() >= alpha)) { 
return true; 
} 
} 


return false; 


} 


int main() { 
seed(); 
long ni; 
cout << "Enter number of intervals --> "; 
cin >> ni; 
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long nreps; 
cout << "Enter number of repetitions --> "; 
cin >> nreps; 


Intervalx list; 
list = new Interval[ni]; 


long count = 0; 
for (long j=0; j<nreps; j++) { 


for (long k=0; k<ni; k++) { 
list[k] = Interval(unif(), unif()); 


} 
if (one_meets_all(list,ni)) count++; 
} 
cout << "Success rate: " << 100*double(count)/double(nreps) 


<< "%" << endl; 


delete[] list; 
return 0; 


Here is a sample run of the program. 


Enter number of intervals --> 100 


Enter number of repetitions --> 100000 
Success rate: 66.659% 





7.3 


It appears that about 5 of the time there is an interval that meets all the others. 
One might conjecture that as n — ©, the probability there is such an interval 
2 


approaches = (and this is true). On the other hand, it is not hard to show 


that for n = 2, the probability that the two intervals intersect is exactly 3. 
The surprise is that for any value of n > 2, the probability there is an interval 
that intersects all the others is ;. [Reference: J. Justicz, E. Scheinerman, and 
P. Winkler, Random intervals, American Mathematical Monthly 97 (December 
1990) 881-889. ] 


How can we sort the array and not modify it? Work with a copy. Here’s the 
code. 


#include <iostream> 
#include <algorithm> 
using namespace std; 


double median(const doublex array, long nels) { 
if (nels < 0) return 0.; 
if (nels == 0) return array[0]; 


// make a copy of the array 
doublex copy array; 
copy_array = new double[nels]; 
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for (int k=0; k<nels; k++) copy _array[k] = array[k]; 


// sort the copy 
sort(copy array, copy_arraytnels); 


// extract the single middle element or the averages 
// of two most central elements in the sorted list 
double ans; 


if (nels%2 == 1) { 

ans = copy_array[nels/2]; 
} 
else { 


ans = (copy _array[nels/2] + copy_array[(nels/2)+1]) / 2.; 
} 


// free the copy and return the result 
delete[] copy array; 
return ans; 


7.4 We can modify Program 7.3 to do the work. We need to generate all primitive 


Pythagorean triples containing a leg or a hypotenuse whose length is at most 


100. To do this, we run the constructor PTriple(m,n) for all m,n < 100. 


Note that if either m or n is greater than 100, then all three of 2mn, m2 —n?, 


and m? + n* exceed 100 and may be ignored. Here’s a program. 


#include "PTriple.h" 
#include <iostream> 
#include <algorithm> 
using namespace std; 


/ xx 
x Count the number of triples with a given leg and 
* a given hypotenuse 


«/ 

int main() { 
PTriplex table; // table to hold the triples 
const int N = 100; // maximum length we're counting 


int leg count[N+1]; // tally leg lengths 
int hyp count[N+1]; // tally hypotenuse lengths 


// Make sure counters are all zero 
for (int k=0; k<=N; k++) { 
leg_count[k] = 0; 
hyp_count[k] = 0; 
} 


// Allocate space for the table 
table = new PTriple[2«N«N]; 


// Populate the table with all possible PTriples 
long idx = 0; // index into the table 
for (long m=1; m<=N; mt++) { 
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for (long n=1; n<=N; nt++) { 
PTriple P = PTriple(m,n); 
if (P.getA() <= N) { 
table[idx] = P; 
idx++; 


} 


// Sort the table 
sort(table, tabletidx); 


// Process unique elements in the tables 
leg _count[table[0].getA() ]++; 
leg _count[table[0].getB() ]++; 
hyp_count[table[0].getC() ]++; 


for (int k=1; k<idx; k++) { 
if (table[k] != table[k-1]) { 
long a,b,c; 
a = table[k].getA() 
b table[k].getB() 
c = table[k].getC(); 


, 
, 


if (a<=N) leg_count[a]++; 

if (b<=N) leg_count[b]++; 

if (c<=N) hyp _count[c]++; 
} 


} 
cout << "Length\tLeg\tHypotenuse" << endl; 


for (int k=0; k<=N; k++) { 
cout << k << "\t" << leg _count[k] << "\t" 
<< hyp_count[k] << endl; 


} 
// Release memory held by the table 


delete[] table; 
return 0; 


When the program is run, we see the following output. 


Length Leg Hypotenuse 
1 


oooorocooro 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
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92 2 0 
93 2 0 
94 0 0 
95 2 0 
96 2 0 
97 dh 1 
98 0 0 
99 2 0 
100 2 0 





For an explanation of these results, see: Eric W. Weisstein. “Pythagorean 
Triple.” From MathWorld—A Wolfram Web Resource. 


http: //mathworld.wolfram.com/PythagoreanTriple.html 


8.1 Declare a set of sets of integers as set< set<long> > x; Incidentally, the 
following does not work: set<set<long>> xX; because the >> can be con- 
fused with the right-shift operator. 


Here’s code to build the set 123% {4,5}, {6}}. 


#include <set> 
using namespace std; 


int main() { 
set<long> tmp; 
set< set<long> > bigset; 


tmp.insert(1); 
tmp.insert(2); 
tmp.insert(3); 
bigset.insert(tmp) ; 


tmp.clear(); 
tmp.insert(4); 
tmp.insert(5); 
bigset.insert(tmp) ; 


tmp.clear(); 
tmp.insert(6); 
bigset.insert(tmp) ; 


return 0; 


8.2 The procedure should be declared as 


void print _set(const set<int>& A); 


Here is the program. 


#include <set> 
#include <iostream> 
using namespace std; 


8.3 


8.4 
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void print_set(const set<int>& A) { 


long n = A.size(); // number of el’ts in the set 
long k; // for counting the set 
set<int>::iterator Ai; // iterator into the set 


cout << "{"s 


k = 0; 
for (Ai = A.begin(); Ai != A.end(); ++Ai) { 

cout << «Ai; 

++k; 

if (k < n) cout << ","; // comma if not the last element 
} 


cout << "}"; 


C++ set containers may only be used to house data types for which < and 
== are defined. The complex<double> type does not define <, so we cannot 
house these objects in a set. 


However, C++ ordered pairs (pair<typel,type2>) can be held in a set 
provided < is defined for both type1 and type2. 


Although we cannot put the value 2 + 37 into a set, we can put the ordered 
pair (2,3) into a set. We use code that looks like this. 
#include <complex> 


#include <set> 
using namespace std; 


int main() { 
complex<double> z(2.,3.); 
set< pair<double,double> > A; 
A.insert( make_pair(z.real(),z.imag()) ); 
return 0; 


} 
A more satisfactory solution is developed in Exercise 10.3. 


We must show that a, equals the number of ordered factorizations of n. 


Proof. The proof is by induction with the basis case a; = 1 given. Suppose 
the result is true for all values less than n and we ask for the number of ordered 
factorizations of n. We condition on the first term in the factorization; say 
it’s d. The number of ordered factorizations of a, whose first factor is d > 
1 is exactly the number of ordered factorizations of n/d (the balance of the 
factorization), and that equals a,/4 by induction. Summing over all d > | 
gives 
an = > An/d- 
d|n,d>1 


However, this is just a rearranged version of the sum 


ad 
d|n,d<n 
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and the result follows. O 


This sequence also arises in counting the number of perfect partitions of an in- 
teger. See the On-Line Encyclopedia of Integer Sequences, sequence A002033 
and Eric W. Weisstein, “Perfect Partitions,’ from Mathworld—A Wolfram 
Web Resource. 


http://mathworld.wolfram.com/PerfectPartition. html 


Here is a file Partition.h that creates the class (with all methods and pro- 
cedures written inline). 


#ifndef PARTITION _H 
#define PARTITION H 


#include <set> 
#include <iostream> 
#include <vector> 
using namespace std; 


class Partition { 

private: 
/// A maltiset to hold the parts 
multiset<int> parts; 
/// An integer to hold the sum 
int sum; 


public: 
/// Default constructor: create null partition of 0 
Partition() { 
sum = 0; 
parts.clear(); 


} 


/// Add a new part to this partition 
void add_part(int n) { 
if (n <= 0) { 
cerr << "Cannot add nonpositive part to a partition" 
<< endl; 
return; 
} 
parts.insert(n); 
sum += n; 


} 


/// What is the sum of the parts? 
int get_sum() const { return sum; } 


/// How many parts in this partition? 
int nparts() const { return parts.size(); } 


/// Get a vector containing the parts 

vector<int> get_parts() const { 
vector<int> ans; 
ans.resize(nparts()); 
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multiset<int>::iterator pi; 

int idx = 0; 

for (pi=parts.begin(); pi!=parts.end(); pitt) { 
ans[idx] = xpi; 
++idx; 

} 


return ans; 


} 


/// Compare two parts 

bool operator<(const Partition& that) const { 
// first compare the number partitioned 
if (sum < that.sum) return true; 
if (sum > that.sum) return true; 


// same sum, so compare number of parts 
if (nparts() < that.nparts()) return true; 
if (nparts() > that.nparts()) return false; 


// last resort, compare element by element 
vector<int> my parts = get_parts(); 
vector<int> that_parts = that.get_parts(); 


for (int k=0; k<nparts(); k++) { 
if (my_parts[k] < that_parts[k]) return true; 
if (my_parts[k] > that_parts[k]) return false; 
} 


// Only way to reach here is if the partitions are equal 
return false; 
} 
}; 


inline ostream& operator<<(ostream& os, const Partition& P) { 
if (P.get_sum() == 0) { 
os << 0; 
return os; 


} 


vector<int> list = P.get_parts(); 
int np = P.nparts(); 
os << P.get_sum() << "= "; 
for (int i=np-1; i>=0; i--) { 
os << list[i]; 
if (i > 0) os << "+" ; 
} 


return os; 


} 


#endif 


8.6 Here is a program that uses a recursive approach conditioning on the largest 
part in the partition. The procedure make_partitions(n,mp) generates the 
set of all partitions of n whose largest part is at most mp. 


#include "Partition.h" 
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set<Partition> make _partitions(int n, int mp) { 


} 


set<Partition> ans; 
set<Partition> tmp; 


if (mp>n) mp = n; 


if (n==0) { 
ans.insert(Partition()); 
return ans; 


} 


for (int k=1; k<=n; k++) { 
tmp.clear(); 
tmp = make_partitions(n-k,k); 
set<Partition>::iterator sp; 
for (sp = tmp.begin(); sp != tmp.end(); sp+t) 
Partition P = «sp; 
P.add_part(k); 
ans.insert(P); 
} 
} 


return ans; 


set<Partition> make _partitions(int n) { 


} 


return make_partitions(n,n); 


int main() { 


cout << "Enter n: : 
int n; 
cin >> n; 


set<Partition> PS = make_partitions(n); 

set<Partition>::iterator pp; 

for (pp = PS.begin(); pp != PS.end(); ppt++) { 
cout << «*pp << endl; 

} 

cout << PS.size() << " partitions of 

return 0; 


Here is a sample run of the program. 


Enter n: 6 


6 
6 
6 
6 
6 
6 
6 
6 
6 
6 


= 6 

= 54+1 

= 4+2 

= 3+3 

= 44+14+1 

= 3+2+1 

= 2+2+2 
3+1+1+1 

= 2+2+1+1 

= 24+14+14+14+1 





<< n << endl; 
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6 = 14141414141 
11 partitions of 6 


8.7 The solution is to use a static look-up table that takes pairs of long values 
as keys. To create such a table, be sure to #include <map> and give the 
following declaration. 


static map< pair<long,long> , long > table; 


Here is a program with a binomial procedure and a main to check that it 
works. 


#include <map> 
#include <iostream> 
using namespace std; 


long binomial(long n, long k) { 
static map< pair<long,long> , long > table; 


if (k>n) return 0; 
if (k==0) return 1; 
if (k==n) return 1; 


pair<long, long> args = make_pair(n,k); 


if (table.count(args) > 0) { 
return table[args]; 


} 
table[args] = binomial(n-1,k-1) + binomial(n-1,k); 


return table[args]; 


} 


int main() { 
for (int n=0; n<10; n++) { 
for (int k=0; k<10; k++) { 
cout << binomial(n,k) << "\t"; 
} 
cout << endl; 
} 


return 0; 


} 


The code gives Pascal’s triangle as output. 


WOoOrRrWAGeGGDGCC OC 
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The inputs to the procedure are the array and an integer specifying the length 
of the array. The vector can either be the return value of the procedure or a 
reference argument: 


vector<long> array2vector(const longx list, long nels); 


void array2vector(const longs list, long nels, 
vector<long>& vlist); 


The first is, perhaps, more natural, however, the second is more efficient. The 
problem with the first approach is that when the return statement executes, 
the vector<long> built in the procedure is copied to the receiving variable 
in the calling procedure. 


Here is code for the procedure using the second approach. 


#include <vector> 
using namespace std; 


void array2vector(const longs list, long nels, 
vector<long>& vlist) { 
vlist.resize(nels); 
for (int k=0; k<nels; k++) vlist[k] = list[k]; 
} 


The solution is to use iterators that point to the first and one-past-the-last ele- 
ments of the vector like this, 


sort(values.begin(), values.end()); 


The following code illustrates this approach. 


#include <vector> 
#include <iostream> 
using namespace std; 


const int N = 10; 


int main() { 
vector<long> values; 
values.resize(N); 
for (int k=0; k<N; k++) { 
values[k] = rand()%1000; 
cout << values[k] << " "; 


} 


cout << endl << endl; 
sort(values.begin(), values.end()); 
for (int k=0; k<N; k++) cout << values[k] << " "; 


cout << endl; 
return 0; 


Here is the output of this program. 


8.10 
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807 249 73 658 930 272 544 878 923 709 


73 249 272 544 658 709 807 878 923 930 





This is dangerous. The iterator is now focused on a part of a set that no longer 
exists. Such an action renders the iterator invalid. Even worse, all iterators 
referring to the modified set are now invalid. 


It is tempting (but wrong) to write code like this: 


set<long>::iterator sp; 

for (sp = A.begin(); sp != A.end(); ++sp) { 
if (*sp%2 == 1) A.erase(x«sp); 

} 


The problem, as we discussed in the solution to Exercise 8.10, is that once we 
erase the element referred to by an iterator, the iterator becomes invalid. We 
need a different approach. 


The technique we illustrate here is to step through the set and place a copy of 
the odd elements we find in a container (in the following code we use a stack, 
but other choices would work as well). Once we have accumulated copies 
of all the odd elements in the set, we run through the stack and delete the 
corresponding elements from the set. Here’s the code. 


#include <set> 
#include <stack> 
using namespace std; 


void delete_odds(set<long>& A) { 
stack<long> eliminate; 
set<long>::const_iterator sp; 
for (sp=A.begin(); sp!=A.end(); ++sp) { 
if («sp % 2 == 1) eliminate.push(x«sp); 
} 
while (!eliminate.empty()) { 
A.erase(eliminate.top()); 
eliminate. pop(); 
} 
} 


Here is the code. 


#include <set> 

#include <algorithm> 
#include <iostream> 
using namespace std; 


void print _element(long x) { cout << x << 3 } 
void print_set(set<long>& A) { 


cout << "{ "+; 
for_each(A.begin(), A.end(), print_element) ; 
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cout << "}" << endl; 


} 


Note that we first define the procedure print_element. This procedure is 
used as an argument to for_each in the print_set procedure. 


Here is a complete solution. First we present the header file Time.h in which 
the short methods are defined inline. The private method adjust() is used 
to correct the variables so they fall in the proper ranges. For example, if 
the hour/minute/second variables have values (5,59,65), then adjust would 
change these to (6,0,5). 


Notice the use of a static variable ampm_style that is modified via the 
static methods ampm( ) and military(). 


#ifndef TIME_H 
#define TIME_H 


#include <iostream> 
using namespace std; 


class Time { 

private: 
long hour, min, sec; 
static bool ampm_style; 
void adjust(); 


public: 
Time() { hour = min = sec = 0; } 
Time(int H, int M, int S); 
Time operator+(long n) const; 
Time operator-(long n) const; 
Time operator++(); 
Time operator--(); 
int get_hour() const { return hour; } 
int get_minute() const { return min; } 
int get_second() const { return sec; } 
static void ampm() { ampm_style = true; } 
static void military() { ampm_style = false; } 
static bool is_ampm() { return ampm_style; } 


he 


Time operator+(long n, const Time& T); 
ostream& operator<<(ostream& os, const Time& T); 


#endif 

Next we give the code file Time.cc. 
#include "Time.h" 

bool Time::ampm_style = true; 


void Time::adjust() { 
// adjust the seconds field first 


Answers 


if (sec < 0) { 


long change = (-sec)/60 + 1; 
sec += change «* 60; 
min -= change; 

} 


if (sec > 59) { 
long change = sec/60; 
sec -= changex60; 
min += change; 


} 


// adjust the min field next 


if (min < 0) { 


long change = (-min)/60 + 1; 


min += changex60; 
hour -= change; 

} 

if (min > 59) { 
long change = min/60; 
min -= changex60; 
hour += change; 


} 


// finally, adjust the hour 


if (hour < 0) { 
long change = (-hour/24) 
hour += changex24; 

} 

if (hour > 23) { 
hour %= 24; 

t 

} 


Time::Time(int H, int M, int 
hour = H; 


min = M; 
sec = S; 
adjust(); 


} 


Time Time: :operator+(long n) 
Time T = xthis; 
T.sec += n; 
T.adjust(); 
return T; 


} 


Time operator+(long n, const 
return T+n; 


} 


Time Time: :operator-(long n) 
Time T = xthis; 
T.sec -= n; 
T.adjust(); 
return T; 


name 


Ss) { 


const { 


Time& T) 


const { 
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Time Time::operatort++() { 
++sec; 
adjust(); 
return «this; 


} 


Time Time::operator--() { 
--sec; 
adjust(); 
return «this; 


} 


ostream& operator<<(ostream& os, const Time& T) { 
long h = T.get_hour(); 
long m = T.get_minute(); 
long s = T.get_second(); 


if (Time::is_ampm()) { // am-pm style 
if (h==0) { 
os << 12; 
} 


else if (h>12) { 
os << h-12; 


os << "s"+s 

if (m < 10) os << 0; 
os << m; 

os << "3s"; 

if (s < 10) os << 0; 
os << s; 


if (h < 12) { 
os << " am"; 
} 


else { 
os << " pm"; 


else { // military time 
os''<< ho << “ers 
if (m < 10) os << 0; 
os << m << "i"; 
if (s < 10) os << 0; 
os << s; 
} 
return os; 


} 


Finally, the following code shows how to extract the current local time on a 
UNIX computer. Unfortunately, it is difficult to understand. Fortunately, it is 
unusual for a program that solves a mathematics problem to need to deal with 
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the current time of day. 


#include <ctime> 
#include <iostream> 
#include "Time.h" 
using namespace std; 


Time now() { 
time_t clock = time(0); 
long h = localtime(&clock)->tm_hour; 
long m = localtime(&clock)->tm_min; 
long s = localtime(&clock)->tm_sec; 


return Time(h,m,s); 


} 


int main() { 
cout << "At the tone, the time will be " << now() << endl; 
return 0; 


If you need to deal extensively with date and time matters, it is worth your 
while to download, build, and install a package created by someone else. For 
example, the Boost C++ package provides classes for working with date and 
time. (See Chapter 13 about working with packages you find on the Web 
including a brief description of Boost on page 286.) 


Here is the header file EuclideanVector.h. 


#ifndef EUCLIDEAN _VECTOR_H 
#define EUCLIDEAN VECTOR_H 


#include <vector> 
#include <iostream> 
using namespace std; 


class EuclideanVector { 
private: 
static int DEFAULT _DIM; 
int dim; 
vector<double> coords; 


public: 
EuclideanVector(); 
EuclideanVector(int n); 
static int get _default_dim() { return DEFAULT_DIM; } 
static void set_default_dim(int n); 
double get(int n) const; 
void set(int n, double x); 
int get_dim() const { return dim; } 
EuclideanVector operator+(const EuclideanVector& that) const; 
EuclideanVector operators(double s) const; 
bool operator==(const EuclideanVector& that) const; 
bool operator!=(const EuclideanVector& that) const; 
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EuclideanVector operator«(double s, const EuclideanVectoré& v); 
ostream& operator<<(ostream& os, const EuclideanVectoré& v); 


#endif 


Here is the code file EuclideanVector.cc. 


#include "EuclideanVector.h" 
int EuclideanVector::DEFAULT_DIM = 2; 


EuclideanVector: :EuclideanVector() { 
dim = DEFAULT DIM; 
coords.resize(dim) ; 
for (int k=0; k<dim; k++) coords[k] = 0.; 


EuclideanVector: :EuclideanVector(int n) { 
if (n < 0) { 
cerr << "Cannot construct vector with negative dimension" 
<< endl << "using zero instead" << endl; 
n = 0; 
} 
dim = n; 
coords.resize(n); 
for (int k=0; k<dim; k++) coords[k] = 0.; 


void EuclideanVector::set_default_dim(int n) { 
if (n < 0) { 
cerr << "Cannot set default dimension to be negative’ 
<< endl << "using zero instead" << endl; 
n= 0; 
} 
DEFAULT DIM = nj; 


} 


double EuclideanVector::get(int n) const { 
n %= dim; 
if (n < 0) n += dim; 
return coords[n]; 


} 

void EuclideanVector::set(int n, double x) { 
n %= dim; 
if (n < 0) n += dim; 
coords[n] = x; 

} 

EuclideanVector 


EuclideanVector: :operator+(const EuclideanVector& that) const { 
if (dim != that.dim) { 
cerr << "Attempt to add vectors of different dimensions" 
<< endl; 
return EuclideanVector(0); 


} 


EuclideanVector ans(dim); 
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for (int k=0; k<dim; k++) { 

ans.coords[k] = coords[k] + that.coords[k]; 
} 
return ans; 


} 


EuclideanVector 
EuclideanVector: :operatorx(double s) const { 
EuclideanVector ans(dim); 


for (int k=0; k<dim; k++) ans.coords[k] = sxcoords[k]; 
return ans; 
} 
bool 
EuclideanVector: :operator==(const EuclideanVector& that) const { 
if (dim != that.dim) return false; 
for (int k=0; k<dim; k++) { 
if (coords[k] != that.coords[k]) return false; 
} 
return true; 
} 
bool 
EuclideanVector: :operator!=(const EuclideanVector& that) const { 
return !( (*this) == that ); 
} 


EuclideanVector operator«(double s, const EuclideanVectoré& v) { 
return v«s; 


} 


ostream& operator<<(ostream& os, const EuclideanVector& v) { 
os << "UT "3; 
for (int k=0; k<v.get_dim(); k++) os << v.get(k) <<" "; 
os << "J"; 
return os; 


Here are the files S.h and S.cc that implement the set S and its operation *. 


#ifndef S_H 

#define S_H 
#include <iostream> 
#include <cmath> 
using namespace std; 


class S { 


private: 
long n; 
public: 
S() { n = 0; } 
S(long a) { 
if (a<0) a = -a; 
n = a; 
} 


long getN() const { return n; } 
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double value() const { return sqrt(n); } 
S operator«(const S& that) const { return S(n + that.n); } 


hi 
ostream& operator<<(ostream& os, const S& s); 


#endif 


#include "S.h" 


ostream& operator<<(ostream& os, const S& s) { 
os << "sqrt(" << s.getN() << ")"; 
return os; 


} 


9.5 See the file quaaternions.h on the CD-ROM that accompanies this book. 
This file includes embedded Doxygen comments and the CD-ROM includes 
the Web pages they generate. 


10.1 The two classes are defined in the following .h file. There is no need for a 
-cc file. 


#ifndef _RECTANGLE_ 
#define _RECTANGLE_ 


class Rectangle { 
protected: 
double h,w; // hold the height and width 
public: 
Rectangle(double x=1.0, double y=1.0) { 
h = x; 
w= yi 


} 


double get_width() const { return w; } 
double get_height() const { return h; } 


void set_width(double x) { w= x; } 
void set_height(double y) { h = y; } 


double area() const { return hxw; } 
double perimeter() const { return 2.«(h+w); } 


3 


class Square : public Rectangle { 

public: 
Square(double s = 1.) : Rectangle(s,s) { } 
void set_width(double x) { w = x; h = x; } 
void set_height(double y) { w = y; h = y; } 

hi 
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#endif 


10.2 Here is a file parallelogram.h that defines all three classes. 


#ifndef PARALLELOGRAM _H 
#define PARALLELOGRAM _H 
#include <cmath> 


class Parallelogram { 

protected: 
double a,b,c; 

public: 
Parallelogram() { a=b=c= 0.; } 
Parallelogram(double x1, double x2, double y2) { 


if (xl < 0) xl = -xl; 
if (y2 < 0) y2 = -y2; 
a= xl; 
b = x2; 
c = y2; 


} 


double area() const { return cxa; } 
double perimeter() const { 
return 2«sqrt(bxb + cxc) + 2a; 
} 
yi 


class Rectangle : public Parallelogram { 
public: 
Rectangle(double height, double width) 
Parallelogram(width, 0., height) {} 
double perimeter() const { return 2%*a + 2«c; } 


te 


class Rhombus : public Parallelogram { 
public: 
Rhombus(double x, double y) 
Parallelogram(sqrt(x*x)+sqrt(y*y), x, y) {} 
double perimeter() const { return 4x*a; } 


te 


#endif 


10.3. The class mycomp1lex can be defined in a header file, mycomp1lex.h, like this. 


#ifndef MY COMPLEX _H 
#define MY COMPLEX _H 


#include <complex> 
using namespace std; 


class mycomplex : public complex<double> { 

public: 
mycomplex() : complex<double> (0.,0.) {} 
mycomplex(double r) : complex<double> (r,0.) {} 
mycomplex(double r, double i) : complex<double> (r,i) {} 
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bool operator<(const mycomplex& that) const 


if (real() < that.real()) return true; 
if (real() > that.real()) return false; 
if (imag() < that.imag()) return true; 
return false; 


} 


v 


#endif 


We define the three constructors by passing arguments up to the constructor 
for complex<double>. No further action is required by these constructors 
and so the bodies of these three constructors are empty: {}. 


Next the operator < is defined. Note that we use the complex<double> meth- 
ods real() and imag() to access the data, and then use lexicographic order- 


ing. 


Here is a short main to test the mycomp1lex class. 


#include "mycomplex.h" 
#include <iostream> 
#include <set> 

using namespace std; 


int main() { 


mycomplex z; 
mycomplex w(2); 
mycomplex v(-5,2); 


set<mycomplex> S; 
S.insert(z); 
S.insert(w); 
S.insert(v); 


set<mycomplex>::iterator si; 
for (si = S.begin(); si != S.end(); ++si) 
cout << *si << " ">; 


} 


cout << endl; 


return 0; 


This produces the following output. 


(-5,2) (0,0) (2,0) 


10.4 The difficulty here is that each class depends on the other, leaving us in a 
quandary as to which to define first. In C++ one must declare classes and 
variables before they can be used. So, the solution is to give a preliminary 
declaration of the Segment class before giving a full declaration of Point. 
This is done with the statement class Segment; in the header file. 
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The operator+ in Point uses the Segment(Point,Point) constructor 
to convert a pair of points into a line segment. We cannot put the code for 
operator-+ inline in the declaration of the Point class because the required 
Segment (double,double) constructor has not yet been declared. So we 
are compelled to write the code for operator+ in a separate .cc file. 


Here are the files pointseg.h and pointseg.cc. 


#ifndef POINTSEG_H 
#define POINTSEG H 


#include <iostream> 
using namespace std; 


class Segment; 


class Point { 
private: 
double x,y; 
public: 
Point() { x = y = 0; } 
Point(double xx, double yy) { 
xX = XX; 
Y= Y¥s 
} 
double getxX() const { return x; } 
double getY() const { return y; } 
Segment operator+(const Point& that) const; 


he 


class Segment { 

private: 
Point A,B; 

public: 
Segment() { A = Point(0,0); B 
Segment(Point X, Point Y) {A 
Point getA() const { return A; } 
Point getB() const { return B; } 
Point midpoint() const; 


Point(1,;0)+ } 
X; B= Y; } 


ostream& operator<<(ostream& os, const Point& P); 
ostream& operator<<(ostream& os, const Segmenté& S); 


#endif 


#include "pointseg.h" 


Segment Point::operator+(const Point& that) const { 
return Segment(*xthis, that); 
} 


Point Segment::midpoint() const { 
double x = (A.getX() + B.getX()) / 2; 
double y = (A.getY() + B.getY()) / 2; 
return Point(x,y); 
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} 


ostream& operator<<(ostream& os, const Point& P) { 
os << "(" << P.getX() << "," << P.getYy() << ")"; 
return os; 


} 


ostream& operator<<(ostream& os, const Segment& S) { 
os << "[" << S.getA() << "," << S.getB() << "]"; 
return os; 


} 


No. Suppose that class Alpha declares a data member of type Beta and vice 
versa. If this were allowed, we could create an infinite nesting: Alpha objects 
contain Beta objects which in turn contain Alpha objects, ad infinitum. 


Examine this header file and the problem should become clear. 


class Beta; 


class Alpha { 
private: 

Beta b; 
}; 


class Beta { 
private: 

Alpha a; 
}; 


Trying to #include this header file into a program generates a compiler error 
message like this. 


In file included from alphabeta.cc:1: 


alphabeta.h:5: error: field ‘b’ has incomplete type 





The key idea is to derive Complexx as a subclass of complex<double> and 
add two Boolean data fields to signal whether the object is infinite and whether 
the object is invalid. To save some typing, we typedef the symbol C to be 
shorthand for complex<double>. 


To define the arithmetic operators, we rely on the corresponding operators 
from complex. To convert an object z of type Complexx to its parent class C, 
we use the expression C(z). So, to multiple Complexx objects w and z, we 
first check for special cases where either is infinite or invalid, and then to get 
the required product we may use the expression C(w) *C(z). 


Here are the files Complexx.h and Complexx.cc. To make this class more 
useful, we should add the operators +=, -=, «=, and /=. We should also extend 
all the arithmetic operators so that one of the arguments can be a double. 


#include <complex> 
using namespace std; 
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typedef double R; 
typedef complex<R> C; 


el 
pr 


pu. 


ass Complexx public Cc { 

ivate: 

bool infinite; 

bool invalid; 

blic: 

Complexx(C z) C(z) { 
infinite = false; 
invalid = false; 

} 

Complexx(R a, R b) 
infinite = false; 
invalid = false; 


C(a,b) { 


} 


bool isZero() const { 


return !invalid && !infinite && C(«*this) == C(0); 


} 
bool isInfinite() const { 
return !invalid && infinite; 


} 


bool isInvalid() const { return invalid; } 


bool operator==(const Complexx& that) const { 
if (invalid || that.invalid) return false; 
if (infinite && that.infinite) return true; 


return C(*this) == C(that); 
} 


bool operator!=(const Complexx& that) const { 


if (invalid || that.invalid) 
return !(*this == that); 


} 


return false; 


Complexx 
Complexx 
Complexx 
Complexx 
Complexx 


he 


operator+(const Complexx& 
operator-() const; 

operator-(const Complexx& 
operators (const Complexx& 
operator/(const Complexx& 


that) 


that) 
that) 
that) 


const; 


const; 
const; 
const; 


ostream& operator<<(ostream& os, 


#include "Complexx.h" 


Complexx Complexx: :operator+(const Complexx& that) const { 


const Complexx& 2); 


Complexx ans(C(*this) + C(that)); 


if (invalid || that.invalid) { 
ans.invalid = true; 
return ans; 

} 

if (infinite && that.infinite) 
ans.invalid = true; 


{ 
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return ans; 

} 

if (infinite || that.infinite) { 
ans.infinite = true; 
return ans; 

} 


return ans; 


} 


Complexx Complexx::operator-() const { 
Complexx ans(-C(«this) ); 
if (invalid) { 
ans.invalid = true; 
return ans; 

} 

if (infinite) { 
ans.infinite = true; 
return ans; 

} 

return ans; 


} 


Complexx Complexx: :operator-(const Complexx& that) const { 
return (*this) + (-that); 
} 


Complexx Complexx: :operators (const Complexx& that) const { 
Complexx ans(C(*this) *« C(that)); 
if (invalid || that.invalid) { 
ans.invalid = true; 
return ans; 

} 

if (infinite && that.isZero()) { 
ans.invalid = true; 
return ans; 

} 

if (isZero() && that.infinite) { 
ans.invalid = true; 
return ans; 


} 

if (infinite || that.infinite) { 
ans.infinite = true; 
return ans; 

} 

return ans; 


} 


Complexx Complexx::operator/(const Complexx& that) const { 
Complexx ans(C(«this) / C(that)); 
if (invalid || that.invalid) { 
ans.invalid = true; 
return ans; 
} 
if (isZero() && that.isZero()) { 
ans.invalid = true; 
return ans; 


11.1 


11.2 
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} 

if (infinite && that.infinite) { 
ans.invalid = true; 
return ans; 

} 

if (infinite) { 
ans.infinite = true; 
return ans; 

} 

if (that.infinite) { 
ans = Complexx(0.,0.); 
return ans; 

} 

if (that.isZero()) { 
ans.infinite = true; 
return ans; 

} 


return ans; 


} 


ostream& operator<<(ostream& os, const Complexx& z) { 
if (z.isInvalid()) { 
os << "INVALID"; 
return os; 


} 

if (z.isInfinite()) { 
os << "Infinity"; 
return os; 


} 
os << C(z); 
return os; 


Here is a hint. Suppose that z is written in disjoint cycle notation. The order 
of z is the least common multiple of lengths of the cycles. Also for positive 
integers a and b, the least common multiple of a and b is ab/ gcd(a,b). 


Here is the file Counted.h. Notice how we use the constructor just to incre- 
ment the variable n_objects and the destructor to decrement it. 


#ifndef COUNTED _H 
#define COUNTED_H 


class Counted { 
private: 
static long n_objects; 


public: 

Counted() { n_objects++; } 

“Counted() { n_objects--; } 

long static count() { return n_objects; } 
hi 


#endif 


462 C++ for Mathematicians 


This header file contains nearly everything except the code to initialize the 
static class variable n_objects. This is done in a separate source file, 
Counted.cc: 


#include "Counted.h" 
long Counted::n_objects = 0; 


11.3 Here are the files Partition.h and Partition.cc. 


#ifndef PARTITION _H 
#define PARTITION _H 
#include <iostream> 
using namespace std; 


class Partition { 
private: 
int sum; 
int n_parts; 
int «xparts; 


public: 
Partition() { 
sum = n_parts = 0; 
parts = new int[1]; 
} 


Partition(const Partition& that) { 
sum = that.sum; 
n_parts = that.n parts; 
parts = new int[n_parts+1]; 
for (int k=0; k<n_parts; k++) parts[k] = that.parts[k]; 
} 
“Partition() { 
delete[] parts; 
} 
Partition operator=(const Partition& that) { 
sum = that.sum; 
n_parts = that.n parts; 
delete[] parts; 
parts = new int[n_parts+1]; 
for (int k=0; k<n_parts; k++) parts[k] = that.parts[k]; 
return xthis; 
} 
void add_part(int n); 
int get_sum() const { return sum; } 
int nparts() const { return n_parts; } 
int operator[](int k) const; 
bool operator<(const Partition& that) const; 


yi 

ostream& operator<<(ostream& os, const Partition& P); 
#endif 

#include "Partition.h" 


void Partition::add_part(int n) { 
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if (n <= 0) { 
cerr << "Cannot add a negative part" << endl; 
return; 

} 

sum += n; 

ints new_parts = new int[n_parts+1]; 

for (int k=0; k<n_parts; k++) { 
new_parts[k] = parts[k]; 

} 

new_parts[n_parts] = n; 

n_parts+t+; 

sort(new_parts, new_partst+n_parts); 

delete[] parts; 

parts = new_parts; 


} 


int Partition::operator[](int k) const { 
if ((k<0) || (k>=n_parts)) { 
cerr << "Index out of range" << endl; 
return -1; 
} 
return parts[k]; 


} 


bool Partition: :operator<(const Partition& that) const { 
if (sum < that.sum) return true; 
if (sum > that.sum) return false; 
if (n_parts < that.n_parts) return true; 
if (n_parts > that.n_parts) return false; 
for (int k=0; k<n_parts; k++) { 
if (parts[k] < that.parts[k]) return true; 
if (parts[k] > that.parts[k]) return false; 
} 


return false; 


ostream& operator<<(ostream& os, const Partition& P) { 
if (P.nparts() < 2) { 
os << P.get_sum(); 
return os; 
} 
for (int k=0; k<P.nparts(); k++) { 
os << P[k]; 
if (k < P.nparts()-1) os << "+"; 
} 


return os; 


11.5 Here is the file SmartArray.h that implements the class. 


#ifndef SMART ARRAY H 
#define SMART ARRAY H 


class SmartArray { 
private: 
long N; 
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longs data; 
long adjust_index(long k) { 
k = N; 
if (k<0) k += N; 
return k; 
} 
public: 
SmartArray(long nels = 1) { 
N = (nels > 1) ? nels : 1; 


data = new long[N]; 
} 
“SmartArray() { delete[] data; } 
long get_N() const { return N; } 
long& operator[](long k) { 
long kk = adjust_index(k); 
return data[kk]; 


} 
he 


#endif 


Note that we define two private data elements: N (the size of the array) and 
data (a place to hold the data elements). 


We also define a private method adjust_index that maps an array index to 
fall between 0 and N-1 (inclusive). 


The constructor, after ensuring that its argument is at least 1, allocates storage 
for the data array. The destructor’s only job is to release the memory held by 
data. The get_N method is a convenient way to learn the size of the array. 
(Note: In this implementation we do not provide any way to resize an array.) 


And now we come to the main point of this exercise: the operator[ ] method. 
Notice that we declared the return type of this method to be longs. If we had, 
instead, declared the return type to be long, then return data[kk]; would 
simply return a copy of the value held in slot kk of the data. This is just like 
call by value, but in this case, it’s return by value. 


By declaring the return type to be long&, we switch from returning a copy of 
a value to returning the actual item itself; that is, we have implemented return 
by reference. 


Suppose the following statements appear in a main(), 


SmartArray X(10); 
X[-1] = 4; 


The first declares X to be a SmartArray housing 10 values. When the second 
statement is encountered, here’s what happens. First adjust_index(-1) 
runs and returns the value 9 (and that’s held in the temporary variable kk). 
Next the code executes return data[-1];. So the statement X[-1] = 4; 
is, effectively, transformed into X.data[9] = 4;. 


11.6 
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The following code is a file named LFT.h that defines the class LFT. No- 
tice that we defined c to be an abbreviation for complex<double>. We 
include get methods to extract the coefficients of the transformation and an 
operator<< to print the transformations to the screen. 


#ifndef LFT_H 

#define LFT_H 

#include <complex> 
#include <iostream> 

using namespace std; 
typedef complex<double> C; 


class LFT { 
private: 
C a,b c,d: 
public: 
LFT(C aa, C bb, C cc, C dd) { 
a= aa; b = bb; c = cc; d = dd; 


LFT() { 
a=1; b= 0; c=0; d=1; 


getA() const { return a; 
getB() const { return b; 
getC() const { return c; 
getD() const { return d; 
operator()(C z) const { 
return (axztb)/(cx«z+d); 
} 

LFT operators(const LFT& T) const { 
Cc aa,bb,ecc,dd; 

aa = axT.a + beT.c; 

bb = axT.b + bxT.d; 

cc = cxT.a + deT.c; 

dd = cxT.b + dxT.d; 

return LFT(aa,bb,cc,dd); 


qgqagaangaaw 
wwe ee 


} 
yi 
inline ostream& operator<<(ostream& os, const LFT& T) { 
os << "Zz |--> (" << T.getA() << "«*z + " << T.getB() 
<< ")/(" << T.getC() << "*z + " << T.getD() 
<< ")"; 
return os; 
} 
#endif 


The files Path. h and Path.cc follow. Note that we used a vector container 
to house the points. This is easier than managing a Paths array. As a bonus, 
because we do not need to delete[ ] any arrays we allocated, we do not need 
a ~Path() destructor. 


Also note that we did not define an operator+ for the case Path+Point. 
The C++ compiler knows how to convert a Point to a Path (thanks to the 
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single-argument constructor). However, a separate Point+Path procedure is 
necessary. 


#ifndef PATH_H 
#define PATH_H 
#include "Point.h" 
#include <vector> 


class Path { 
private: 
vector<Point> pts; 
long npts; 
public: 
Path() { npts = 0; } 
Path(const Point& P) { 
npts = 1; 
pts.resize(1); 
pts[0] = P; 
} 
long size() const { return npts; } 
Path operator+(const Path& that) const; 
Point operator[](int k) const; 


he 


Path operator+(const Point& X, const Path& P); 
ostream& operator<<(ostream& os, const Pathé& P); 


#endif 


#include "Path.h" 


Path Path: :operator+(const Path& that) const { 
Path ans; 
ans.npts = npts + that.npts; 
ans.pts.resize(ans.npts); 


for (int k=0; k<npts; k++) ans.pts[k] = pts[k]; 
for (int k=0; k<that.npts; k++) ans.pts[k+npts] = that.pts[k]; 


return ans; 


} 


Point Path::operator[](int k) const { 
if (npts==0) return Point(0,0); 
k = npts; 
if (k<0) k = -k; 
return pts[k]; 
} 


Path operator+(const Point& X, const Path& P) { 
return Path(X) + P; 


} 


ostream& operator<<(ostream& os, const Path& P) { 
os << "[ "3 
for (int k=0; k<P.size(); k++) os << P[k] << " "; 
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os << "]"5 
return os; 


} 


12.1 The code is a mildly edited version of the answer to Exercise 7.3; it works for 
any type for which the < is defined. Here is the file median.h. 


#ifndef MEDIAN _H 
#define MEDIAN_H 
#include <algorithm> 
using namespace std; 


template <class T> 

T median(const Tx array, long nels) { 
if (nels < 0) return 0.; 
if (nels == 0) return array[0]; 


Tx Copy array; 
copy_array = new T[nels]; 
for (int k=0; k<nels; k++) copy _array[k] = array[k]; 


sort(copy array, copy_arraytnels); 


T ans; 

ans = copy_array[nels/2]; 
delete[] copy array; 
return ans; 


} 
#endif 


There is an interesting difference between the algorithm we use here and the 
algorithm used in our solution to Exercise 7.3. In the first version, if the array 
contains an even number of elements, we return the average to the two central 
values. However, this new version might be applied to a type for which addi- 
tion and division by 2 is not defined. Our solution is to return element number 
|n/2| of (the sorted copy of) an array with n elements. 


12.2 Here is the new version of SmartArray.h. 


#ifndef SMART ARRAY H 
#define SMART ARRAY H 


template <class T> 
class SmartArray { 
private: 
long N; 
Tx data; 
long adjust_index(long k) { 
k = N; 
if (k<0) k += N; 
return k; 


} 


public: 
SmartArray(long nels = 1) { 


468 


123 


12.4 


12.5 


C++ for Mathematicians 


N = (nels > 1) ? nels : 1; 
data = new T[N]; 
} 
“SmartArray() { delete[] data; } 
long get_N() const { return N; } 
T& operator[](long k) { 
long kk = adjust_index(k); 
return data[kk]; 
} 
hi 


#endif 


Here is a file derivative.h that creates a template procedure derivative. 


#ifndef DERIVATIVE_H 
#define DERIVATIVE _H 
#include "Polynomial.h" 


template <class T> 
Polynomial<T> derivative(const Polynomial<T>& P) { 
Polynomial<T> ans; 


for (long k=1; k<=P.deg(); k++) { 
ans.set(k-1,k*xP[k]); 
} 


return ans; 


} 
#endif 


Alternatively, we could add a derivative() method to the Polynomial 
class template. 


Here is some advice on handling multiple roots. If p(x) has multiple roots, 
then (x) 
D(x 
a) = Ss Gat 
ged(p(x), p'(x)) 


has the same roots as p(x), but all the roots are simple. 


Here is a file triple.h that defines the triple class and the make_triple 
procedure templates. 


#ifndef TRIPLE _H 
#define TRIPLE_H 


template <class A, class B, class C> 
class triple { 
public: 

A first; 

B second; 

Cc third: 


triple() {}; 
triple(const A& x, const B& y, const C& z) { 
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first = x; second = y; third = 2; 


bool operator<(const triple& that) const { 
if (first < that.first) return true; 
if (first > that.first) return false; 
if (second < that.second) return true; 
if (second > that.second) return false; 
if (third < that. third) return true; 
return false; 

} 

hi 


template <class A, class B, class C> 
triple<A,B,C> make _triple(const A& x, const B& y, const C& z) { 
return triple<A,B,C>(x,y,Z); 


} 


#endif 


Use the Polynomial template created in this chapter as a basic building block. 
Your template should start like this: 


template <class T> 
class RationalFunction { 
private: 
Polynomial<T> numerator; 
Polynomial<T> denominator; 
public: 


he 


Notice that in the following program we do not use C++’s set containers. The 
print_set procedure takes an integer, examines each of its bits, and prints 
out a set element when it finds a nonzero bit. 


#include <iostream> 
using namespace std; 


int LIMIT = 8xsizeof(unsigned long); 
void print_set(unsigned long x) { 


cout << "{ "“s 
for (int k=0; k<LIMIT; k++) { 


unsigned long mask = 1<<k; 

if ((x&mask) != 0) cout << k+l << ""; 
} 
cout << "}" << endl; 


} 


int main() { 
cout << "Enter n (up to " << LIMIT-1 << ") --> "; 
int n; 
cin >> n; 
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if ((n<0) || (n>=LIMIT)) { 
cerr << "Please use a positive value that is less than 
<< LIMIT << endl; 
return -1; 


} 


unsigned long top = (1l<<n) - 1; 


for (unsigned long x = 0 ; x <= top; x+t+) { 
print_set(x); 
} 


return 0; 


Here is a sample run. 


nter n (up to 31) --> 3 


E 
{ 
{ 
{ 
{ 
{ 
{ 
{ 
{ 





Of course, the “right” way to solve this problem is to see that there are 24 
factors of 5 in 100!. Here is a solution that uses the GMP package. 


#include <iostream> 
#include "gmpxx.h" 
using namespace std; 


mpz class factorial(long n) { 
mpz_ class ans(1); 
for (int k=2; k<=n; k++) ans «= k; 
return ans; 


} 


int main() { 
mpz class value = factorial(100); 


int count = 0; 
while (value % 10 == 0) { 
value /= 10; 
count++; 
} 
cout << count << endl; 
return 0; 


Here is the program. 


#include <iostream> 
using namespace std; 


const int NROWS = 21; 


14.1 


14.2 
14.3 


14.4 
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int main() { 
int table[NROWS][NROWS]; 


table[0][0] = 1; 
for (int k=1; k<NROWS; k++) table[0][k] = 0; 


for (int n=1; n<NROWS; n+t+) { 
table[n][0] = 1; 
table[n][n] = 1; 
for (int k=1; k<n; k++) 
table[n][k] = table[n-1][k-1]+table[n-1][k]; 
for (int k=n+1l; k<NROWS; k++) table[n][k] = 0; 
} 


for (int n=0; n<NROWS; n++) { 
for (int k=0; k<NROWS; k++) { 
cout << table[n][k] << "\t"; 
} 


cout << endl; 


} 


return 0; 


} 


To extend this to a 100 x 100 table, it is not enough to change the value of 
NROWS. The binomial coefficients grow too large to fit in long variables. 
Even long long variables are not big enough (assuming that these are 64 
bits). Instead, we need to use arbitrary precision integers (e.g., from the GMP 
package) or settle for decimal approximations (i.e., use a doub1e table). 


Here are two solutions. First, we can convert the string into a char» array, 
and then use atoi: 
int n; 


n = atoi(s.c_str()); 


Alternatively, we can wrap the string inside an istringstream and then 
extract the integer value using the >> operator: 

istringstream is(s); 

int n; 

is >> n; 


ifstream fin(file_name.cstr()); 

The addition of a char and an int results in an int, and so instead of writing 
the letters a through z, instead we see the ASCII values for these letters. 

The solution is to replace 'a’+k with char(’a’+k). 

Here are the header and code files, Free. h and Free.cc, that implement the 


Free class. Note that we include constructors for building Free objects from 
a single character, a string, and a chars array. The helper methods named 
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reduce are used to cancel adjacent inverse elements. The clear_check 
method is used by the constructor to prevent the inclusion of improper charac- 
ters. 


#ifndef FREE_H 
#define FREE_H 
#include <iostream> 
#include <cctype> 
using namespace std; 


class Free { 
private: 
string word; 
bool reduce(int k); 
void reduce(); 
void check_clear(); 
public: 
Free() { word.clear(); } 
Free(char ch) { 
word = string(" "); 
word[0]=ch; 
check _clear(); 
} 
Free(const string& S) { 
word = S; 
check _clear(); 
} 
Free(const charx str) { 
word = string(str); 
check_clear(); 
} 
string toString() const { return word; } 
Free operator«(const Free& that) const { 
Free ans; 
ans.word = word + that.word; 
ans.reduce(); 
return ans; 
} 


Free inverse() const; 


he 


inline 

ostream& operator<<(ostream &o0s, const Free& f) { 
os << ‘'(’ << f£.toString() << ')’; 
return os; 

} 

#endif 


#include "Free.h" 


void Free::check clear() { 
for (unsigned k=0; k<word.size(); k++) { 
while (!isalpha(word[k])) { 
word.erase(k,1); 


} 
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} 


reduce(); 


} 


bool Free::reduce(int k) { 
char cl = word[k]; 
char c2 = word[k+1]; 
if ((islower(cl)&&isupper(c2)) || (isupper(c1l)&&islower(c2))){ 
if (toupper(cl) == toupper(c2)) { 
word.erase(k,2); 
return true; 
} 
} 


return false; 


} 


void Free::reduce() { 
if (word.size() < 2) return; 
for (int k=0; k<int(word.size())-1l; k++) { 
while (reduce(k)) { 
if (k>0) --k; 
} 
} 
} 


Free Free::inverse() const { 

Free ans; 

ans.word = word; 

int n = int(word.size()); 

for (int k=0; k<n; k++) { 
char ch = word[k]; 
ch = isupper(ch) ? tolower(ch) : toupper(ch); 
ans.word[n-1-k] = ch; 

} 


return ans; 


14.5 The following program reads a text file (given as a command-line argument) 
and reports letter frequencies. 


#include <iostream> 
#include <fstream> 
using namespace std; 


int main(int argc, charx* argv) { 

ifstream fin; 

if (arge < 2) { 
cerr << "Usage: " << argv[0] << " filename" << endl; 
return 1; 

} 

fin.open(argv[1]); 

if (fin.fail()) { 
cerr << "Unable to open " << argv[1] << " for reading" 

<< endl; 

return 2; 


} 
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string word; 

long count[26]; 

long total = 0; 

for (int k=0; k<26; k++) count[k] = 0; 


while (true) { 
fin >> word; 
if (fin.fail()) break; 
for (int k=0; k<word.size(); k++) { 
char ch = tolower(word[k]); 
if (isalpha(ch)) { 
count[ch-'a’ ]++; 


total++; 
} 
} 
} 
for (char ch=’a’; ch <= ‘2’; ch++) { 
int idx = ch - ‘a’; 
cout << ch << "\t" << 100«*double(count[idx])/double(total) 
<< endl; 
} 
return 0; 


We ran this code on four 19th-century texts; three of these were in English 
and one in French. The results are in the accompanying table. It’s not hard to 
distinguish one from the other three. 


A complete program to count polygrams in a text file is included on the ac- 
companying CD-ROM. 


The following program uses the Point class from Chapter 6 (files Point.h 
and Point.cc) plus the files Koch. h, Koch.cc, and main.cc that we present 
here. 


#ifndef KOCH_H 
#define KOCH_H 


#include <vector> 
#include <cmath> 
#include "Point.h" 
using namespace std; 


class Koch { 


private: 
vector<Point> pts; 


public: 
Koch(int n=0); 
int size() const { return pts.size(); } 
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Letter frequency chart to accompany solution to Exercise 14.5. 


| Letter | | Frequency (percent) 
84] 8.7) 8.1 . 


a 
b 
c 
d 
e 
f 
g 
h 
i 
J 
k 
1 
m 
n 
e) 
p 
q 
r 
S 
t 
u 
v 
w 
x 
y 
Z 





Point get(int k) const { return pts[k]; } 
hi 


void koch_step(const Point& P, const Pointé& Q, 
Point& X, Point& Y, Point& Z); 


#endif 


#include "Koch.h" 


Koch: :Koch(int n) { 
if (n<0) n=0; 
pts.push_back(Point(0,0)); 
pts.push_back(Point(1,0)); 


for (int k=0; k<n; k++) { 
vector<Point> tmp; 
for (unsigned j=0; j<pts.size()-1; j++) { 
Point P = pts[j]; 
Point Q = pts[jt+1]; 
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Point X,Y,Z; 
koch_step(P,Q,X,Y,Z)j; 
tmp.push_back(P); 
tmp.push_back(X); 
tmp.push_back(Y); 
tmp.push_back(Z); 


} 
tmp.push_back(Point(1,0)); 
pts = tmp; 


} 
} 


const double theta = M PI/3; 


void koch_step(const Point& P, const Pointé& Q, 
Point& X, Point& Y, Point& Z) { 


double a = P.getX(); 
double b = P.getY(); 
double c = Q.getX(); 
double d = Q.getY(); 


X = Point( (2*atc)/3, (2*btd)/3 ); 


Z = Point( (a+2*c)/3, (b+t2*d)/3 ); 
double x = (c-a)/3; 
double y = (d-b)/3; 


double xx cos(theta)*x - sin(theta)x«y; 
double yy = sin(theta)*x + cos(theta)xy; 


Y = Point( X.getX() + xx, X.getY() + yy); 


#include "Koch.h" 
#include "plotter.h" 
#include <fstream> 
using namespace std; 


const chars OUTPUT_FILE = "koch.eps"; 


int main() { 
int n; 
cout << "Enter depth: "; 
cin >> n; 
Koch K(n); 
PlotterParams params; 
ofstream pout(OUTPUT_FILE); 
PSPlotter P(cin,pout,cerr,params) ; 


if (P.openpl() < 0) { 
cerr << "Unable to open plotter for file " 
<< OUTPUT_FILE << endl; 
return 1; 


} 


P, fspace(0.,0.,1.,1.)¢ 
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for (int k=0; k<K.size()-1; k++) { 
double xl K.get(k).getX(); 
double yl = K.get(k).getY(); 
double x2 = K.get(k+1).getX(); 
double y2 K.get(k+1).getY(); 
P.fline(xl,yl,x2,y2); 

} 


P.closepl(); 
return 0; 


When run at depth 5, the following image is produced. 


14.8 Here is a program to draw the Mandelbrot set. 


#include <iostream> 
#include <fstream> 
#include <complex> 
#include "plotter.h" 
using namespace std; 


const int MAX ITS = 500; 
const int PIXELS = 1000; 
const charx FILE NAME = "mandelbrot.gif"; 


double norm(complex<double> z) { 
double a = z.real(); 
double b = z.imag(); 
return axa + bxb; 


} 


bool in_set(complex<double> c) { 
complex<double> z = 0.; 
for (int k=0; k<MAX_ITS; k++) { 
Z= Z*Z + C7 
if (norm(z) > 4.) return false; 
} 


return true; 


} 


complex<double> pix _to_complex(int i, int j) { 
double a = (4.2«i)/PIXELS - 2.1; 
double b = (4.2«j)/PIXELS - 2.1; 
return complex<double>(a,b); 


} 
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int main() { 
PlotterParams params; 
ofstream pout(FILE NAME) ; 
GIFPlotter P(cin, pout, cerr, params); 
if (P.openpl() < 0) { 
cerr << "Unable to open plotter for file " << FILE NAME 
<< endl; 
return 1; 


} 


P.space(0,0,PIXELS,PIXELS) ; 
P.pencolorname("black"); 
for (int i=0; i<PIXELS; i++) { 
for (int j=0; j<PIXELS; jt++) { 
complex<double> z = pix _to_complex(i,j); 
if (in_set(z)) { 
P.point(i, )? 
} 
} 
} 
P.closepl(); 
return 0; 


It produces the following image. 





15.1 Here is Card.h with all methods and procedures inline. 


#ifndef CARD_H 
#define CARD_H 


#include <vector> 
#include <string> 
#include <iostream> 
using namespace std; 


const int ACE = 1; 
const int JACK = 11; 
const int QUEEN = 12; 
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const int KING = 13; 

const string value_names[] = { "nil", "ace", "two", "three", 
"four", "five", "six", "seven", 
"eight", "nine", "ten", 
"jack", "queen", "king" }; 


const string suit_names[] = { "clubs", "diamonds", 
"hearts", "spades" }; 


enum Suit { CLUBS, DIAMONDS, HEARTS, SPADES }; 


class Card { 
private: 
int value; 
Suit suit; 
int card2int() const { 
return 13*suit + value; 


} 


public: 

Card() { value = ACE; suit = SPADES; } 

Card(int spots, Suit family) { 
spots %= 13; 
if (spots <= 0) spots += 13; 
value = spots; 
suit = family; 

} 

bool operator<(const Card& that) const { 
return card2int() < that.card2int(); 

} 

bool operator==(const Card& that) const { 
return card2int() == that.card2int(); 

} 

bool operator!=(const Card& that) const { 
return card2int() != that.card2int(); 

} 


friend ostream& operator<<(ostream& os, const Card& C); 


he 


inline ostream& operator<<(ostream& os, const Card& C) { 
os << value_names[C.value] << " of " 
<< suit_names[C.suit]; 
return os; 


} 


#endif 


15.2 The statement Tx xp = new 1T(10); creates a single new object of type T 
in which the value 10 is supplied to the class T constructor. 


The statement Tx xp = new T[10]; creates a new array to hold 10 objects 
of type T. 


15.3 Notice that in the following program we catch a bad_alloc that is thrown by 
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new when there is not enough memory to allocate. (The prefix std:: is not 
necessary because we declared using namespace std;.) 


#include <iostream> 
using namespace std; 


int main() { 
long size = 10000000; // ten million 
longs array; 


long count = 0; 
while (true) { 
try { 


array = new long[size]; 

} 

catch (bad_alloc X) { 
cerr << "Unable to allocate memory" << endl; 
exit(1); 

} 


++count; 
cout << "Success with array #" << count << endl; 


+, x+y addition or string concatenation, x++ and ++x increment, and unary 
+x is the identity function (not mentioned elsewhere in this book). 


-. a-b subtraction, -x unary minus, x-- and --x decrement, and combined 
with > to give -> arrow operator. 


x. axb multiplication, »x pointer/iterator dereferencing, typex var point- 
er/array declaration, and combined with / to delimit comments: /* and «/. 


/. a/b division and// single line comment. See also «. 


=. a=b assignment, a==b equality testing, combined with < and > for < and 
>, and combined with ! for inequality testing. 


<. a<b for less than, a<<b for bit shift and stream output, and used with > for 
declaring templates and for #include of standard headers. See also =. 


>. a>b for greater than, a>>b for bit shift and stream input. See also =, -, and 
>. 


!. !a Boolean not. See also =. 


&. a&b bitwise and, &a address of, type& var reference declaration, a&&b 
Boolean and. 


|. a|b bitwise or and a| |b Boolean or. 
~. ~a bitwise not and ~Class destructor. 


:. class : public subclass inheritance, label: statement; label- 
ing, case 1: label ina switch statement, 


Child(argument_list) : Parent(argument_sublist) { ... } 


15.5 
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parent class constructor invocation, Class: :name/namespace: :name scope 
resolution, and a?b:c in the trigraph operator. 


This is a tricky problem combining many of the concepts we have encountered 
in this book. 


Each constructible number can be represented as an expression tree. For ex- 
ample, the golden mean (1 + /5)/2 can be parsed like this. 




































































There are three types of nodes in this tree: 


— Atomic nodes that contain integers. 
— Unary operations nodes (\/ and unary —) that have one child. 
— Binary operation nodes (+, binary —, x, and +) that have a left and a 
right child. 
Each child node is, itself, a constructible number. 


Our solution begins by defining the data elements of the Constructible 
class. They are: 


An operation code op. This field indicates the type of node: an atomic 
node (i.e., an integer), a unary operation, or a binary operation. To this 
end we define an enum type called Operation that is one of NOP (for an 
atomic node), PLUS, MINUS, TIMES, DIVIDE, NEG, or SORT. 


— An integer val field. This is only used in the case where this is an atomic 
node. 


— An integer nargs field. This is 0 for an atomic node, | for a unary 
operation, or 2 for a binary operation. It tell us how many direct children 
this node has. 


— An array args containing the children. This array is dynamically allo- 
cated and its size is given in nargs. 


The constructor creates an atomic node with a given integer value. The var- 
ious operator methods create Constructible objects with one or two ar- 
guments (saved in the args array). An assignment operator is needed when 
copying a Constructible object so that a true independent copy is created. 
Because various operations allocate storage (via new), we need to be mindful 
to release that storage (e.g., in the destructor). 


482 


C++ for Mathematicians 


The code for the binary operator methods are remarkably similar, so we write a 
private helper method named binary_op. A similar unary_op is provided 
for the negation and square root. 


The procedure to produce a decimal (complex) value for a Constructible 
object works recursively on the structure of the object. Note that the Standard 
Template Library does not define a square root method for complex<double> 
values, So we write our own. 


The header Constructible.h and code files Constructible.cc follow. 


#ifndef CONSTRUCTIBLE H 
#define CONSTRUCTIBLE H 
#include <iostream> 
#include <complex> 
using namespace std; 


enum Operation { NOP, PLUS, MINUS, TIMES, DIVIDE, NEG, SORT }; 


class Constructible { 
private: 
Operation op; 
long val; 
int nargs; 
Constructible xargs; 
Constructible binary _op(Operation verb, 
const Constructible& that) const; 
Constructible unary _op(Operation verb) const; 


public: 
Constructible(long x = 0) { op = NOP; val = x; nargs = 0; } 
“Constructible() { 
if (nargs > 0) { 
delete[] args; 
} 
} 
Constructible(const Constructible& X); 
Constructible& operator=(const Constructible& that); 
Constructible operator+(const Constructible& that) const { 
return binary _op(PLUS,that) ; 
} 
Constructible operator-() const { return unary _op(NEG); } 
Constructible operator-(const Constructible& that) const { 
return binary _op(MINUS,that) ; 
} 
Constructible operator«(const Constructible& that) const { 
return binary _op(TIMES,that) ; 
} 
Constructible operator/(const Constructible& that) const { 
return binary _op(DIVIDE, that); 
} 
Constructible sqrt() const { return unary _op(SQRT); } 
complex<double> value() const; 
friend ostream& operator<<(ostream& os, 
const Constructible& X); 


he 
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inline Constructible operator+(long a, Constructible X) { 
return Constructible(a) + X; 

} 

inline Constructible operatorx(long a, Constructible X) { 
return Constructible(a) * X; 

} 

inline Constructible operator-(long a, Constructible X) { 
return Constructible(a) - X; 

} 

inline Constructible operator/(long a, Constructible xX) { 
return Constructible(a) / X; 


} 





complex<double> complex _sqrt(const complex<double>& z); 


inline Constructible sqrt(const Constructible& X) { 
return X.sqrt(); 


} 
#endif 


#include "Constructible.h" 
#include <cmath> 


Constructible: :Constructible(const Constructible& xX) { 

op = X.op; 
val = X.val; 
nargs = X.nargs; 
if (nargs > 0) { 

args = new Constructible[nargs]; 

for (int k=0; k<nargs; k++) { 

args[k] = X.args[k]; 
} 


} 


Constructible& 
Constructible: :operator=(const Constructible& that) { 
op = that.op; 
val = that.val; 
if (nargs > 0) { 
delete[] args; 
} 
nargs = that.nargs; 
if (nargs > 0) { 
args = new Constructible[nargs]; 
for (int k=0; k<nargs; k++) { 
args[k] = that.args[k]; 
} 
} 


return «this; 


} 


Constructible 
Constructible::binary_op(Operation verb, 
const Constructible& that) const { 
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Constructible ans; 
ans.op = verb; 


ans.nargs = 2; 
ans.args = new Constructible[2]; 
ans.args[0] = xthis; 


ans.args[1] = that; 
return ans; 


} 


Constructible 
Constructible::unary_ op(Operation verb) const { 
Constructible ans; 
ans.op = verb; 
ans.nargs = 1; 
ans.args = new Constructible[1]; 
ans.args[0] = xthis; 
return ans; 


} 


complex<double> Constructible::value() const { 

switch(op) { 

case NOP: 
return complex<double>(double(val),0); 
break; 

case PLUS: 
return args[0].value() + args[1].value(); 
break; 

case MINUS: 
return args[0].value() - args[1].value(); 
break; 

case NEG: 
return -args[0].value(); 
break; 

case TIMES: 
return args[0].value() * args[1].value(); 
break; 

case DIVIDE: 
return args[0].value() / args[1].value(); 


break; 
case SQRT: 
return complex sqrt(args[0].value()); 
break; 
default: 
cerr << "This shouldn’t happen!" << endl; 
} 
return complex<double>(0); 
} 
const chars OPEN = "\\left("; 
const char* CLOSE = "\\right)"; 


ostream& operator<<(ostream& os, const Constructible& X) { 
switch(X.op) { 
case NOP: 
os << X.val; 
break; 
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case PLUS: 
os << OPEN << X.args[0] << " + " << X.args[1] << CLOSE; 
break; 
case MINUS: 
os << OPEN << X.args[0] << " - " << X.args[1] << CLOSE; 
break; 
case TIMES: 
os << OPEN << X.args[0] << " \\times " << X.args[1] 
<< CLOSE; 
break; 
case DIVIDE: 
os << "\\frac{" << X.args[0] << "}{" << X.args[1l] << "}"; 
break; 
case NEG: 
os << "-" << OPEN << X.args[0] << CLOSE; 
break; 
case SQRT: 
os << "\\sqrt{" << X.args[0] << "}"; 
break; 
default: 
os << "INVALID CONSTRUCTIBLE OBJECT"; 
} 


return os; 


} 


complex<double> complex _sqrt(const complex<double>& z) { 
double x = z.real(); 
double y = z.imag(); 
if ((x==0.) && (y==0.)) return complex<double>(0.); 
if (y==0.) { 
if (x >= 0.) { 
return complex<double>(sqrt(x),0); 
} 
else { 
return complex<double>(0., sqrt(-x)); 
} 
} 
double r = sqrt(hypot(x,y)); 
double t = atan2(y,x)/2.; 
return complex<double> (r«cos(t), r*xsin(t)); 


The following brief main( ) illustrates the use of the Constructible class. 


#include "Constructible.h" 
int main() { 
Constructible five(5); 


Constructible PHI = (l+sqrt(five))/2; 

cout << "PHI = " << PHI.value().real() << endl; 
cout << "TeX form: " << PHI << endl; 

return 0; 


This gives the following output. 
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PHI = 1.61803 
Tex form: \frac{\left(1 + \sqrt{5}\right) }{2} 


. (14+V5) 
The TX code produces this: ~ —. 


Showing that two Constructible objects represent the same complex num- 
ber is tricky so we did not define an == operator. See E.R. Scheinerman, 
“When close enough is close enough,” American Mathematical Monthly 107 
no. 6 (June—July 2000) 489-499 for one approach. 





15.6 A full solution is available on the accompanying CD-ROM. In this solution we 
use several classes. 


— Token: Objects of this type are “atoms” of a Boolean expression. This 
may be a variable, a constant, a unary operation, or a binary operation. 
— Expression: Objects of this type represent Boolean expressions. 


— LookupTable: These are devices that associate Boolean values with 
variables. 


— ExpressionLoader: This is a device to read input streams and produce 
Expression objects. 


— TautologyChecker: This is a device that runs through all possible sub- 
stitutions for the variables in an Expression to see if any yield FALSE. 
If not, then the expression is a tautology. 
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Boolean expression, 360 
Boost, 286, 451 
Box—Muller method, 62 
break, 42, 334, 337 
break point, 375, 377 
@brief, 25, 382, 389 
Buffon’s needle, 64 

@bug, 390 

bus error, 353 
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case, 334, 397 

cast, 19, 44, 100 

catch, 338, 339, 398 

catch all, 342 

Cauchy sequence, 98 

cbrt, 409 

cc, 5, 399 

cctype, 331 

cd, 366 


ceil, 409 
cerr, 34, 108, 300 
cfloat, 16 
CGAL, 286 
char, 14, 289, 391 
character 
array, 5, 289-291, 306, 471 
control, 412 
string, 289 
Chinese Remainder Theorem, 68, 88, 
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Cholesky factorization, 278-280, 284 
CHomP, 287 
cin, 20, 300 
circle, 320 
class, 93, 401-408 
container, 127 
template, 238-242, 407 
class, 96 
clear, 128, 136, 140, 144, 303 
climits, 16 
clique, 330 
close, 302 
closepl, 320 
cmath, 21, 64, 94, 97, 102, 112, 123, 
408 
@code, 389 
code file, 94, 399 
colon, 182, 337 
comma, 395 
command line argument, 297-300 
comment, 7 
comparison operator, 22 
compiled language, 4 
compiler, 4 
complex, 23, 238 
complex number, 23-27 
complexx, 24 
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Library, 286 
Computational Homology Program, 287 
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condition number, 280 
const, 25, 58, 82, 83, 102, 105, 
108, 132, 147, 167, 276, 297, 
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constructor, 96, 99, 116, 402 
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copy, 219, 221, 261, 405 
container class, 127 
continue, 42 
control character, 412 
copy, 275 
copy constructor, 219, 221, 261, 405 
cos, 64, 410 
cosh, 410 
count, 128, 140, 262 
cout, 5, 34, 107, 108, 300 
csh, 364 
cstdlib, 54, 56, 413 
cstring, 291 
ctime, 56, 414 
ctype, 411, 412 
cube root, 409 
~CxXxX, 5 
CXXFLAGS, 371 
Cygwin, 364 


data hiding, 96, 97 

@date, 390 

dec, 311 

declaration, 12 

decreasing subsequence, 215 

decrement operator, 20, 404 

Dedekind cut, 98 

default, 334, 397 

default parameters, 195, 400 

#define, 26 

delete, 355-356 

delete[], 81, 124, 127, 134, 135, 
219, 223, 273, 353, 355, 393 

deprecated, 274 

deque, 149 

dereference, 107, 130, 351, 352 

derivative, 265 

Desargues’ Theorem, 212 

destructor, 220, 402 
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determinant, 279, 284 

disjoint cycle notation, 215, 225 
do, 41, 42, 397 

double, 14, 391 

double inclusion, 26, 33, 96 
Doxyfile, 388 

Doxygen, xxi, 25, 33, 364, 381-390 
duality, in RP’, 178 


edge, 326 
eigenvalue, 278, 283, 284 
else, 76, 396 
emacs, 363-365 
c++-mode, 365 
empty, 128, 136, 140, 144, 148, 294 
end, 131, 133, 141, 144 
end of file, 304 
@endcode, 389 
#endif, 26 
endl,6 
enum, 348, 481 
enumeration, 348 
epsilon, 16 
equality operator, 14 
erase, 128, 140, 145, 293 
Erdés—Szekeres Theorem, 215, 229 
erf, 410 
Euclid’s method, 37, 247 
Euler 
rhymes with, 9 
totient, see totient 
exception, 135, 338, 398 
executable file, 4 
exit, 33, 341, 413 
exp, 21, 394, 410 
exponentiation, 21 
extension, 5 
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fabs, 112 
factorial, 39 
factoring, 71 
fail, 301-304 
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falling through cases, 334 
false, 261 
fast Fourier transform, 284 
fcircle, 320 
Fibonacci, 49 
file 
ASCII, 301 
binary, 301 
code, 94, 399 
executable, 4 
extension, 5 
header, 6, 24, 32, 94, 399 
object, 4 
plain text, 301 
source, 4 
stream, 301 
tar, 316 
@file, 25, 382, 389 
fillcolorname, 320, 328 
filltype, 320, 328 
find, 133, 295 
find_first_of, 296 
find_last_of, 296 
first, 139, 142 
fixed, 311 
fline, 320 
flinewidth, 319 
flip, 262 
float, 14, 391 
floor, 64, 410 
flowchart, 73 
fmod, 410 
for, 36, 42, 396 
for_each, 153 
free group, 331 
Free Software Foundation, 363 
friend, 344-347, 406 
front, 149 
fspace, 319 
fstream, 301 
function, 31 
identity, 480 
member, 94 
rational, 265 
signum, 49 
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—g, 369 
gt+, 4, 363, 364 
gamma function, 410 
Gaussian 
integer, 23, 115, 238, 391 
poetry, 6 
random variable, 61 
gcd, 31 
extended, 45—49 
polynomial, 247 
get, 305 
get method, 98 
getline, 306 
GIFPlotter, 322, 325 
global 
constant, 25, 165 
variable, 25, 164, 165 
GMP, 269, 286 
gmp_randclass, 270 


GNU Multiple Precision Library, 269, 
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Gnu software, 363 
good, 301-304 
goto, 336-337, 398 
gprof, 369 
graph, 326 

simple, 327 
graphics, 315 
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H, 176 

.h, 399 

header file, 6, 24, 32, 94, 399 
heap, 356 

Hello world, 4 

hex, 311 

Hilbert matrix, 280, 284 
hypot, 410 
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IDE, 4, 363, 372 
identity function, 480 
if, 34, 76, 396 
#ifndef, 26 
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increment operator, 20, 404 
independent set, 330 
inf, 338, 416 
infinity, 212, 338, 348, 416 
line at, 177, 178, 188 
point at, 177 
inheritance, 177, 181 
inline, 119, 165, 168, 196, 236, 241, 
401, 435 
inline procedure, 119 
insert, 128, 140, 145, 293 
int, 11,391 
_-int 64, 12, 391 
INT_MAX, 16 
INT_MIN, 16 
integer 
factoring, 71 
Gaussian, 23, 115, 238, 391 
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4, 363, 372 
interval, 125 
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iomanip, 86, 309 
ios: :app, 302 
ios::floatfield, 3ll 
iostream, 6, 7, 34, 107 
isalnum, 412 
isalpha, 412 
iscntrl, 412 
isdigit, 412 
isgraph, 412 
isinf, 338 
islower, 412 
isnan, 338 
isprint, 412 
ispunct, 412 
isspace, 412 
istringstream, 307, 471 
isupper, 331, 412 
isxdigit, 412 
iterator, 129 

















491 


deque, 149 

list, 144 

map, 141 

read only, 147 

set, 130-133, 153, 447 
vector, 446 


JAMA, 274 
join, 326 


key/value pair, 139 
Koch curve, 332 


-L, 272, 282, 369 

~1, 272, 282, 369 

label, 337 

LCG, 53, 57-59 

least squares, 279 

LEDA, 287 

left, 310 

left shift operator, 5 

length, 294 

lexicographic ordering, 117, 126, 139, 
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library, 272, 282, 320, 369 

Library of Efficient Data Structures and 
Algorithms, 287 

LiDIA, 286 

line, 320 

linear congruential generator, 53, 57— 
59 

linear fractional transformation, 234 

linear system of equations, 279 

LineParser, 312 

linker, 4 

linking, 368 

list, 144-148 

loader, 4 

log, 410 

1og10, 410 

logical operator, 22, 394 

long, 12, 391 

long double, 14, 391 

long long, 12, 391 

look-up table, 142, 445 
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loop statements, 41 
ls, 366 
LU-factorization, 278-280 


_ constants, 411 
M_PI, 21,97 
main, 8, 32 
make, 317, 364, 368, 370-372 
make_pair, 139, 140 
Makefile, 370 
Mandelbrot set, 332 
manipulator, 309 
map, 139-144 
matrix inverse, 279 
matrix multiplication, 277 
Matrix Template Library, 286 
max_size, 136 
median, 126, 264 
member functions, 94 
memory leak, 81, 90, 135, 220, 358, 
402, 427 

method, 32, 93, 94 

get, 98 

private, 117, 167 

set, 98 

static, 157, 163, 166, 232 
million/billion/trillion rule of thumb, 
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mod operator, 19-20 
monic, 247 
monotone subsequence, 215 
Monte Carlo, 60 
mpf_class, 270 
mpg_class, 270 
mpz_class, 270 
multiline comment, 7 
multimap, 144 
multiple inclusion, 187 
multiset, 133-134 
my complex, 239 
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namespace, 274 
standard, 7 

nan, 338, 416 
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new, 80, 81, 124, 273, 353, 355-356, 
393 
newmat, 282-286 
Newton’s method, 265 
noboolalpha, 311 
none, 262 
normal random variable, 61, 62 
noshowpoint, 309 
not a number, 338, 416 
nouppercase, 311 
npos, 295 
null terminated, 289-290 
number 
complex, 23-27 
constructible, 359 
random, 53 
uniform, 54 
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oct, 311 

ofstream, 301 
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open, 302 

openpl, 319 

operator, 97 
address-of, 350 
arithmetic, 18-20 
assignment, 131, 221-223, 404 
bitwise, 259-260 
comparison, 22 
decrement, 20, 404 
equality, 14 
increment, 20, 404 
left shift, 5 
logical, 22, 394 
mod, 19-20 
overloading, 104 
relational, 167 
right shift, 20 

operator, 105, 224, 403-404 
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order, of a permutation, 232 
ordered pair, 138-139, 441 
ostream, 107, 108 
ostringstream, 307 
overflow, 13, 50, 171, 417 
overloading 

operator, 104 

procedure, 46, 54 
override, 183 


—p, 369 
pair, 138, 230, 239, 441 
Paley graph, 326-330 
Pappus’s Theorem, 178, 207 
@param, 33, 383, 389 
partition, 152 
perfect, 442 
Pascal’s triangle, 287, 322, 445 
identity, 153 
PDP-8, 3 
-pedantic, 368, 371 
pencolor, 319 
pencolorname, 319 
permutation, 215 
order, 232 
—pg, 369 
pigeonhole principle, 216 
Plotter, 317 
plotutils, 316-330 
poetry, bad, 4 
pointer, xxii, 70, 124, 350-358 
dereferencing, 107, 130 
polar method, 62 
polygram, 331 
polynomial, 235 
derivative, 265 
monic, 247 
pop, 148-150 
pop_back, 145, 149 
pop_front, 145, 149 
positive definite, 279 
postdecrement, 21 
postincrement, 21 
pow, 21, 394, 410 
predecrement, 21 
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preincrement, 21 
preprocessor, 7 
prime number theorem, 80 
primitive Pythagorean triple, 115 
priority_queue, 150 
private, 402 
private, 97, 104, 182 
procedure, 8, 32 
friend, 344-347 
inline, 119 
overloading, 46 
schema, 237 
template, 235-238, 277, 400 
prof, 369 
profiling tool, 369 
project, 372 
projective plane, 177-178 
protected, 184, 408 
pseudo random number generator, 53, 
271 
PSPlotter, 318 
public, 402 
public, 97, 98, 182 
push, 148, 150 
push_back, 137, 145, 149 
push_front, 144, 149 
put, 306 
pwd, 366 
Pythagorean triple, 115 
primitive, 115 
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quadratic residue, 327 
quaternion, 176 

queue, 148 

quotation mark, 6 
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RAND_MAX, 54, 55, 414 
random 
interval, 126 
variable 
Gaussian, 61 
normal, 61, 62 
walk, 65 
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randomized algorithm, 45 
rank, 279 
rational function, 265 
rbegin, 131 
real part, 23 
recursion, 39 

infinite, 39 
reference, 47, 107, 147 
remove, 145 
remove_if, 145, 147 
rend, 131 
replace, 293 
reserve, 136, 245 
reset, 262 
resize, 135 
rethrow, 343 
return 

by reference, 464 

by value, 464 

type, 33 
@return, 33, 383, 389 
return, 33, 34, 47, 398 
reverse Polish notation, 360 
rfind, 296 
right, 310 
right shift operator, 20 
roundoff, 11, 14, 201, 419 
RP?, 177-178 
RPN, 360 


schema, 237 
scientific, 3ll 
scientific notation, 14 
second, 139, 142 
@see, 389 
seed, 53, 55, 56, 271 
segmentation fault, 353 
Seldon, 286 
semicolon, 5, 95, 396 
set 
independent, 330 
Mandelbrot, 332 
set, 127-133, 262 
set method, 98 
set fill, 310 
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setw, 310 
sh, 364 
short, 12, 391 
showpoint, 309 
showpos, 311 
Sierpinski’s triangle, 324, 326 
Sieve of Eratosthenes, 78, 79, 137 
signum, 49 
simple graph, 327 
simplicial complex, 154 
sin, 410 
single-line comment, 7 
singular value decomposition, 278, 284 
sinh, 411 
size, 128, 135, 140, 144, 149, 262, 
294 
size_t, 128 
sizeof, 12, 15,355, 395 
Sloane, Neil, 87 
sneaky trick, 22, 218 
sort, 123, 126, 145, 153 
sort requires algorithm, 124 
source file, 4 
space, 319 
sqrt, 94, 112, 123, 411 
srand, 56, 414 
sstream, 307 
stack, 355, 447 
stack, 148 
standard namespace, 7 
starting statement, 36 
statement 
advancing, 36 
catch, 339 
declaration, 12 
label, 337 
starting, 36 
terminator, 5 
throw, 339 
static, 58, 63, 143, 164, 166, 392, 
405, 424, 428 
three usages, 166 
std::cout, 7 
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trncepy, 291 
truct, 347 
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public, 182 
subscript, 70 
subsequence, 215 
substr, 294 
SVD, 278, 284 
switch, 333-336, 397 
Sylvester’s four-point problem, 64 
symmetric matrix, 279, 283 
system header file, 6 
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target, 371 
tautology, 360 
template, 133 
class, 238-242, 407 
procedure, 235-238, 277, 400 
Template Numerical Toolkit, 274 
test, 262 
do not name your program, 380 
test condition, 36 
text editor, 4 
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throw, 338, 339, 344, 398 
tilde, 220 
time, 56, 271, 414 
time/memory tradeoff, 143 
time_t, 56 
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top, 148, 150 
totient, 31, 45, 67-69, 76, 83, 85 
toupper, 331, 413 
trace, 277, 284 
trigraph, 224, 395 
try, 338, 339, 398 
twos complement, 258 
type, 11 
return, 33 
typedef, 23, 349, 458 


Ulam’s problem, 215, 229, 231 
unary minus, 170 

unicode, 289 

unif, 54,55 

uniform random number, 54 
union, 133, 348 
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uppercase, 311 

user header file, 6 

using namespace std, 7, 380 
utility, 138, 230 
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global, 25, 164, 165 
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@version, 390 
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view, 275 
Visual Studio, 372-376 
visualization, 315 
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volatile, 27 


-Wal11, 368, 371 


496 C++ for Mathematicians 
while, 39, 41, 397 

X11, 365 

Xcode, 365, 372, 376-378 


Xemacs, 364 


Zn, 157 


